[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: documenting schemas/DTDs

  • From: Tim Bray <tbray@t...>
  • To: "'xml-dev@i...'" <xml-dev@i...>
  • Date: Wed, 17 Nov 1999 20:45:31 -0800

Re: documenting schemas/DTDs
At 09:45 PM 11/17/99 -0600, W. Eliot Kimber wrote:

>Note that the focus must be on the *documentation*, not the
>declarations. That's because it's the documentation that counts in the
>long run. The declarations are so much syntax. Without the documentation
>the declarations are useless, but with the documentation, the
>declarations can be recreated at will. 

I reproduce Eliot's paragraph in full because it is profoundly true and 
rewards repeated reading.  DTD's and XML Schemas both are *just syntax* 
dammit, and syntax is not interesting.  XML, at the end of the day, is not 
interesting.  Messages that convey meaning are interesting.  Meaning is 
only conveyed by

 (a) running code, or
 (b) human-readable prose.

To generate (a), you have to have (b) first.

End of the story. -Tim

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/ and on CD-ROM/ISBN 981-02-3594-1
To unsubscribe, mailto:majordomo@i... the following message;
unsubscribe xml-dev
To subscribe to the digests, mailto:majordomo@i... the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@i...)


Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
First Name
Last Name
Subscribe in XML format
RSS 2.0
Atom 0.3

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.

Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.