minor comments for WD-xml-c14n-20000710

Here are just a few minor comments for your Last Call Canonical XML 
[1] "work in progress."

Is "Canonical" a proper noun? It is lowercase in "canonical form" and 
uppercase in "Canonical XML." I would make it lowercase globally, 
except when referring to the title of this spec.

"REQUIRED" and "MUST" seem to be used in the RFC 2119 sense. You 
might say so, and add http://www.ietf.org/rfc/rfc2119.txt to 
References.

Below, a clause and paragraph number are followed by a quote and then 
a suggestion. Comments are in brackets [].

2. par. 7
[Define QName here, rather than wait until the last par. of clause 4.]

2. par. 8
URI
[You might add a [URI] link, and add 
http://www.ietf.org/rfc/rfc2396.txt to References.]

2. par. 10, list item 4
XPath recommendation
XPath Recommendation

Clause 3, "Document Order for Canonical XML," needs to be numbered "3".

4. par. 4, list item 3
reference
reference 

5. last par.
NOTE:XML
NOTE: XML

A.1. par. 1
rational
rationale

A.2.
"...However, the statement in Namespaces in XML that "the
     prefix functions only as a placeholder for a namespace
     name" is incorrect."
[Is it a known errata item? A negative comment inside a specification 
about another spec. seems somehow out of place without what you term 
"resolution." Sorry I didn't find it in a quick search of 
xml-names-editor, or in 
http://www.w3.org/XML/xml-names-19990114-errata. Maybe in place of 
"is incorrect" say "needs clarification" or "needs modification"?]

A.2.
Proof:Let [twice]
Proof: Let

Remark:The
Remark: The

Theorem 2:With
Theorem 2: With

Remark:Since
Remark: Since

conclusion to be draw
conclusion to be drawn

XML-related recommendations, working drafts
XML-related Recommendations, Working Drafts

A.3.
nodes (they are bound...).
[I would make that two, shorter sentences:]
nodes. (They are bound....)

[1] http://www.w3.org/TR/2000/WD-xml-c14n-20000710

Best wishes for your project,
-- 
Susan Lesch, W3C
mailto:lesch@w3.org

Received on Friday, 14 July 2000 09:10:30 UTC