QA Proof Reading - XML-Query

To Editors of XML Query,

Thanks for the work done. :)

QA proof reading for XQuery

I have read these recommendations and have few preliminary comments.

General comments:

- Lack of Conformance section for each recommendations: It's very 
important to define in our recommendations a conformance section to 
help us to maintain the quality of implementations.

- It's also very important to clearly define how the principles and 
elements/attributes should/must be implemented in software.

- Some graphics could be added to fully explain the concepts and 
understand what's behind... but if you add few graphics, please do it 
uniformly (same style, consistent variable name, consistent 
representation, etc.). You are not supposed to be graphic designer, 
so it could be good to have someone to draw the graphics in a nice 
form.


----------------------------
*** XQuery: A Query Language for XML ***
http://www.w3.org/TR/2001/WD-xquery-20010215/

*** XML Query Data Model ***
http://www.w3.org/TR/2001/WD-query-datamodel-20010215/

+ 6 Example
A graph is included which is not very readable and nice. It may be improved.

*** XML Query Algebra ***
http://www.w3.org/TR/2001/WD-query-algebra-20010215/

+ Problem with the stylesheet: lot of blue lines in the document (Mac IE 5.5)
+ You have designed the formulae with a lot of tables and "font face" 
and "font size" which is not good at all. Use MathML, and SVG, png, 
or gif images to represent the formulae will be better.

*** XML Query Use Cases ***
http://www.w3.org/TR/2001/WD-xmlquery-use-cases-20010215

Very good REC to read. thanks to have done this one.

*** XML Query Requirements ***
http://www.w3.org/TR/2001/WD-xmlquery-req-20010215


+ If this document is intended to be the conformance document for XML 
Query, recall it as the Conformance document.

+ Don't use definition list to indent or make stylistic effects. Use 
Stylesheet.
http://www.w3.org/TR/html4/struct/lists.html#h-10.3
	Definition lists vary only slightly from other types
	of lists in that list items consist of two parts: a term
	and a description. The term is given by the DT element
	and is restricted to inline content. The description is
	given with a DD element that contains block-level
	content.
You don't use dl in this context.






-----------------------------


-- 
Karl Dubost / W3C - Conformance Manager
           http://www.w3.org/QA/

      --- Be Strict To Be Cool! ---

Received on Tuesday, 20 February 2001 17:32:49 UTC