Comments on Ch. 1 of XSL 1.1 WD

I've finished reading the Ch. 1 Introduction of the
Working Draft.  I could only find a few "nitpick"
suggestions, but here's what I found:

1.  In Section 1.1.2, Formatting, the Diagram given in
[1] below, recommend changing text from "Result XML
Tree in the 'fo' namespace (element and attribute
nodes)" to simply, "Element and Attribute Tree".  (The
latter term has already clearly been defined in bold
before, and used twice before reaching this diagram,
so at this stage it seems more important to clarify
the precise name of the tree in question)

[1]
http://www.w3.org/TR/2003/WD-xsl11-20031217/tree2-3.gif


2.  In this same section, the Diagram given in [2]
below, recommend switching Area Tree label from "XSL
areas rendering traits" to simply "Area Tree" or "Area
Tree rendering traits".  

[2]
http://www.w3.org/TR/2003/WD-xsl11-20031217/trees4-5.gif


3.  Section 1.2 [3], this sentence:

"While many of XSL's formatting objects and properties
correspond to the common set of properties, this would
not be sufficient by itself to accomplish all the
goals of XSL."

Recommend changing to:

"While many of XSL's formatting objects and properties
correspond to *a* common set of properties, this would
not be sufficient by itself to accomplish all the
goals of XSL."

or

"While many of XSL's formatting objects and properties
have equivalent counterparts in those standards, this
would not be sufficient by itself to accomplish all
the goals of XSL."

[3]
http://www.w3.org/TR/2003/WD-xsl11-20031217/#d0e253


4.  Section 1.2.1, "Paging and Scrolling"
(http://www.w3.org/TR/2003/WD-xsl11-20031217/#d0e266) 
Change the "can be" below:

In addition, the selection of XML source components
that *can be* styled (elements, attributes, text
nodes, comments, and processing instructions) is based
on XSLT and XPath [XPath], thus providing the user
with an extremely powerful selection mechanism. 

to "are to be"


5.  Section 1.2.3, "An Extended Page Layout Model"
(http://www.w3.org/TR/2003/WD-xsl11-20031217/#d0e307)

Add "possibly" to the below sentence:

This formatting object allows one to define
independently filled regions for the body (with
*possibly* multiple columns), a header, a footer, and
sidebars on a page. 


6.  Finally, if you could add pointers to this new WD
on the Working Group page, it would be helpful for
others to quickly find this new version:

http://www.w3.org/Style/XSL/

Thanks,
Glen


__________________________________
Do you Yahoo!?
Yahoo! Hotjobs: Enter the "Signing Bonus" Sweepstakes
http://hotjobs.sweepstakes.yahoo.com/signingbonus

Received on Sunday, 18 January 2004 23:13:00 UTC