Clearer W3C Specs (was Re: XML Information Set is seeding impenetrable l
----- Original Message ----- From: "Nils Klarlund" <klarlund@r...> To: <xml-dev@i...> Cc: "klarlund" <klarlund@r...> Sent: Wednesday, January 19, 2000 12:22 PM Subject: XML Information Set is seeding impenetrable language; reconsider? > A so-called "last call" working draft has been issued by the W3C for XML > information set. > Although the document is cleanly written, it introduces some very cumbersome > language, > which will almost guarantee that future XML specifications will become > unnecessarily hard to read (just look at the current XML Schema document, > part 1). > > Would it not be in the interest of the XML community to encourage the > authors use > language that mortals understand (nodes, trees, etc)? I don't believe the > Information Set in its current formulation should be accepted. Am I alone > in this belief The need for better writing in W3C specs was discussed at a recent W3C WG meeting I attended. That particular group generally agreed that the specs need to be written more clearly, and the plan (I don't know if anything came of it) was to lobby our W3C Advisory Committee representatives to push the W3C to devote more of its admittedly scarce resources to hiring staff technical writers, or getting members to contribute the time of technical writers as well as XML specialists to the activities of the working groups they participate on. This posting (and a diatribe against the Schema draft that I saw today) reminded me to bring this issue to my AC Rep's attention. Can anyone suggest other concrete proposals for improving the situation? xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev@i... Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/ or CD-ROM/ISBN 981-02-3594-1 Unsubscribe by posting to majordom@i... the message unsubscribe xml-dev (or) unsubscribe xml-dev your-subscribed-email@your-subscribed-address Please note: New list subscriptions now closed in preparation for transfer to OASIS.
PURCHASE STYLUS STUDIO ONLINE TODAY!
Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!
Download The World's Best XML IDE!
Accelerate XML development with our award-winning XML IDE - Download a free trial today!
Subscribe in XML format