- From: Susan Lesch <lesch@w3.org>
- Date: Sun, 15 Feb 2004 20:58:22 -0800
- To: public-qt-comments@w3.org
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