W3C home > Mailing lists > Public > www-xml-schema-comments@w3.org > January to March 2000

please use titles, not addresses, as link text

From: Dan Connolly <connolly@w3.org>
Date: Thu, 10 Feb 2000 16:32:12 -0600
Message-ID: <38A33C6C.4B3341DB@w3.org>
To: www-html-editor@w3.org
CC: www-xml-schema-comments@w3.org, w3t-comm@w3.org
HTML, XML Schema editors,

Please don't use the URI-in-your-face idiom
	<a href="http://...spec-addr">http://...spec-addr</a>
in references sections of W3C tech reports. Please use:

	<a href="http://...spec-addr"><cite>spec-title</cite></a>


To see this in action, see the references section of
"Web Architecture: Extensible Languages"

If the document has an institutionalized identifier (e.g. in
the case of W3C tech reports, which bear their identifier on their
title page) you may want to include it in the citation ala:
But don't do that for just any old document available on the web...
If you want to force hardcopies of your tech report made by broken
tools to include the addresses of a document you're citing, but that
doesn't bear its address, or isn't published on the web
by the original publisher, use the
	Available at: ...
idiom; e.g.

ISO 8601 
     ISO (International Organization for Standardization).
	of dates and times, 1988-06-15. Available at:

Janet, Ian, and w3t-comm folks, please train editors to do this if you
find time.

Hmm... this was documented at/near
at one time, but I don't see it there any more.

See also:

in-your-face URLs: please don't. Dan Connolly (Thu, Aug 12 1999) 

Dan Connolly
Received on Thursday, 10 February 2000 17:34:08 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 23:08:46 UTC