W3C home > Mailing lists > Public > xsl-editors@w3.org > October to December 2002

RE: XSL transformations intro

From: Kay, Michael <Michael.Kay@softwareag.com>
Date: Wed, 27 Nov 2002 15:48:44 +0100
Message-ID: <DFF2AC9E3583D511A21F0008C7E621060453DE0F@daemsg02.software-ag.de>
To: Spencer Kimball <skimball@borland.com>, xsl-editors@w3.org
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:skimball@borland.com] 
Sent: 25 November 2002 16:33
To: xsl-editors@w3.org
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.

skimball@borland.com <mailto:skimball@borland.com> 
Received on Wednesday, 27 November 2002 09:48:52 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:59:53 GMT