RE: XSL transformations intro

This text has been rewritten in the XSLT 2.0 working drafts, and we have no
plans to make editorial improvements to the 1.0 specification at this time.
 
But thanks for taking the time to make the comment. If you can provide any
similar suggestions as to how the readability of the 2.0 specification can
be improved, they will be most welcome.
 
Michael Kay

-----Original Message-----
From: Spencer Kimball [mailto:[email protected]] 
Sent: 25 November 2002 16:33
To: [email protected]
Subject: XSL transformations intro


Dear Editors,

This paragraph is from XSL Transformations (XSLT)
Version 1.0, "1. Introduction":

"A transformation expressed in XSLT is called a stylesheet. This is because,
in the case when XSLT is transforming into the XSL formatting vocabulary,
the transformation functions as a stylesheet."

It struck me that the second sentence negates the first, in that the first
introduces the term "stylesheet" for the first time, and the second assumes
that you already know what it is. It would probably be best either to place
the information in the second sentence later in the document, or provide a
link for the definition of the term if that seems appropriate. At least,
that's my prescription for avoiding a few of the charges of gobbledygook
propagation that the creators of standards documents are heir to ;->

With regards, fwiw,

Spencer Kimball

Borland Software Corp.

[email protected] <mailto:[email protected]>