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

Re: suggested style for links out of a tech report

From: Charles McCathieNevile <charles@w3.org>
Date: Wed, 3 Jan 2001 16:32:43 -0500 (EST)
To: Dan Connolly <connolly@w3.org>
cc: <www-xml-query-comments@w3.org>, <ij@w3.org>, <lesch@w3.org>, <spec-prod@w3.org>
Message-ID: <Pine.LNX.4.30.0101031629080.5911-100000@tux.w3.org>
What I actually prefer is something like

and as _Dan Connolly says_ [_wisdom_] "do it right"

Dan Connolly says    -> where it is on the Web
wisdom               -> the references section of the page
do it right          -> is a quote, and actually includes a cite attribute.

(assuming HTML of course. Actually I am sure there are better examples, but
this shows the idea)

Charles McCN

On Wed, 3 Jan 2001, Dan Connolly wrote:

  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)

Charles McCathieNevile    mailto:charles@w3.org    phone: +61 (0) 409 134 136
W3C Web Accessibility Initiative                      http://www.w3.org/WAI
Location: I-cubed, 110 Victoria Street, Carlton VIC 3053, Australia
until 6 January 2001 at:
W3C INRIA, 2004 Route des Lucioles, BP 93, 06902 Sophia Antipolis Cedex, France
Received on Wednesday, 3 January 2001 16:32:48 UTC

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