W3C home > Mailing lists > Public > public-xml-processing-model-wg@w3.org > March 2008

Re: Uncle! New alternate draft [remainder of comments on section 2]

From: Henry S. Thompson <ht@inf.ed.ac.uk>
Date: Wed, 19 Mar 2008 15:39:42 +0000
To: Norman Walsh <ndw@nwalsh.com>
Cc: public-xml-processing-model-wg@w3.org
Message-ID: <f5bzlsupvsx.fsf@hildegard.inf.ed.ac.uk>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Norman Walsh writes:

[I'm happy with everything you've done, great, thanks]

> | 2.4      A _bit_ more is needed here, or 2.8 is at best difficult to
> |          read and at worst incomprehensible.  A para. about the
> |          difference between option declaration and option binding,
> |          with one example each of select= and value=, perhaps. . .
>
> I'm not sure what section you're actually referring to here...and I'm afraid
> I screwed up and checked in the 'alternate' draft on top of the old one.
> My bad.

New section 2.8, something similar also needed for 2.7
(variables) and 2.9 (params). . ., maybe?

This is arising because section 2 has grown and grown, so that it's a
very long time between the introduction and the point when you get to
the syntax, with simple examples you can understand if you're a
newcomer.  Sigh.  Maybe some of section 2, e.g. 2.7--2.9, some of the
detail in 2.1--2.3, could be moved into the corresponding syntax
sections in 4 and 5?  Sigh again.  Linear text is just _so_ last century.

ht
- -- 
 Henry S. Thompson, HCRC Language Technology Group, University of Edinburgh
                     Half-time member of W3C Team
    2 Buccleuch Place, Edinburgh EH8 9LW, SCOTLAND -- (44) 131 650-4440
            Fax: (44) 131 650-4587, e-mail: ht@inf.ed.ac.uk
                   URL: http://www.ltg.ed.ac.uk/~ht/
[mail really from me _always_ has this .sig -- mail without it is forged spam]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.6 (GNU/Linux)

iD8DBQFH4TO+kjnJixAXWBoRAtuhAJ9Zh+DeSLExycFkgpfWwqHOAO/0GQCdF+te
pSvjW89eGncbhdFbHYSh76M=
=C4GW
-----END PGP SIGNATURE-----
Received on Wednesday, 19 March 2008 15:40:31 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 19 March 2008 15:40:31 GMT