Comments for Last Call

Hello,

Just a few comments for your Last Call Working Drafts [1,2,3,4,5,6].
They are on the whole absolutely beautiful and look like Recs not
Working Drafts. I hope this works for you to have comments grouped
in one email.

Functions and Operators and XPath, XQuery, Serialization (mentions the
RFC, thanks) need conformance sections and RFC 2119 keyword markup.
Data Model and XSLT have a good start. I am not 100% sure that span
class="verb" and strong in those is definite and specific enough.

I would match all tables to cellpadding="3" in the (X)HTML. XSLT uses 5
which is fine too. XSLT and one table in XPath and XQuery (precedence
order) need table summaries.

In the references sections in Functions and Operators [2], XPath [3],
Query [4], Serialization [5] and XSLT [6] the title of the work needs
to be the link, not the URI. Dominique Hazaël-Massieux wrote a
Bibliography Extractor that can help, and the Manual of Style has an
example entry to follow:

http://www.w3.org/2002/01/tr-automation/tr-biblio-ui
http://www.w3.org/2001/06/manual/#ref-section

Because the headings are so uniformly capitalized (this is great), the
exceptions stand out. I would capitalize the heading (and TOC items) in
Functions and Operators chapter 17, XQuery A.2, and "using" and
"arguments" in XSLT.

XSLT would be 200k smaller run through Tidy with indent off. Functions
and Operators would be 260k smaller (by something like 25%). The others
look right.

In Data Model
s/Retreiving/Retrieving/

In XPath and XQuery
s/summarised/summarized/

In XSLT
s/standarization/standardization/
s/sychronization/synchronization/

[1] http://www.w3.org/TR/2003/WD-xpath-datamodel-20031112/
[2] http://www.w3.org/TR/2003/WD-xpath-functions-20031112/
[3] http://www.w3.org/TR/2003/WD-xpath20-20031112/
[4] http://www.w3.org/TR/2003/WD-xquery-20031112/
[5] http://www.w3.org/TR/2003/WD-xslt-xquery-serialization-20031112/
[6] http://www.w3.org/TR/2003/WD-xslt20-20031112/

Best wishes for your projects,
-- 
Susan Lesch           http://www.w3.org/People/Lesch/
mailto:lesch@w3.org               tel:+1.858.483.4819
World Wide Web Consortium (W3C)    http://www.w3.org/

Received on Sunday, 15 February 2004 23:58:28 UTC