W3C home > Mailing lists > Public > public-qt-comments@w3.org > November 2006

[XSLT]: improve abstract

From: Erik Wilde <dret@berkeley.edu>
Date: Wed, 22 Nov 2006 16:21:07 -0800
Message-ID: <4564E973.7010602@berkeley.edu>
To: public-qt-comments@w3.org

xslt 2.0 abstract (minor point):

it would be helpful (for w3c specs in general) if the abstract could be 
read as meaningful text, even when read as text-only (no links). for 
example, the following sentence in the xslt 2.0 abstract is not very 
helpful to readers just reading a textual version:

XSLT 2.0 is designed to be used in conjunction with XPath 2.0, which is 
defined in [XPath 2.0].

why not turn that into:

XSLT 2.0 is designed to be used in conjunction with XPath 2.0.

and make the "XPath 2.0" text into a link with no special text 
characters (or if so, only through css generated content, not as textual 
content).

in general, i think spec abstracts should be carefully written as 
text-only snippets (which may contain links, but only in a form which 
can be safely stripped without sacrificing readabily), because they 
often will be cut and pasted. many w3c specs do not follow this 
guideline, which probably is not an existing guideline, but i would 
propose to introduce such a guideline.

thanks and cheers,

erik wilde   tel:+1-510-6432253 - fax:+1-510-6425814
        dret@berkeley.edu  -  http://dret.net/netdret
        UC Berkeley - School of Information (iSchool)
Received on Thursday, 23 November 2006 03:15:05 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 16:57:16 UTC