W3C home > Mailing lists > Public > spec-prod@w3.org > January to March 2001

suggested style for links out of a tech report

From: Dan Connolly <connolly@w3.org>
Date: Wed, 03 Jan 2001 13:25:54 -0600
Message-ID: <3A537CC2.49B3D21D@w3.org>
To: www-xml-query-comments@w3.org, ij@w3.org, lesch@w3.org, spec-prod@w3.org
I just ran across some links in...

2.1.2 Schema Types

        Nodes contain values that are instances of schema types.
        The following symbols denote schema types: 
             T ranges over _XML schema types_, which are either
             simple or complex. 

--        XML Query Data Model
Thu, 11 May 2000 18:56:19 GMT

I was suprised when the _XML schema types_ link took me to a
different spec altogether, rather than some other section
of this spec.

My experience developing specs leads me to recommend...

When linking from the middle of the document to an external

  1.Ensure that the link text, title, and context indicate you are
     leaving the document, and 
  2.After the link, link to the reference in the references section,
     and indicate section, page, or whatever is useful for those who
     don't use the link (e.g,. when printed). 

Thus, for example: ... as is done for the 'page' property of
CSS2 ([CSS2], section 13.3.2.).

--        How to Release W3C Technical Report
Mon, 30 Oct 2000 05:09:50 GMT

Ian, I think that stuff about references should be moved to a
separate document... a public one. 30 points if you beat me to it.

Ian, Susan, see also our earlier discussion of things to check
w.r.t references

URI citation incorrectly listed as non-normative Dan
     Connolly (Mon, Dec 18 2000) 
         Re: URI citation incorrectly listed as non-normative
         Ian Jacobs (Tue, Dec 26 2000) 

Dan Connolly, W3C http://www.w3.org/People/Connolly/
office: tel:+1-913-491-0501
pager: mailto:connolly.pager@w3.org
  (put return phone number in from/subject)
Received on Wednesday, 3 January 2001 14:25:59 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:55:08 UTC