OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

 


 

   Re: documenting schemas/DTDs

[ Lists Home | Date Index | Thread Index ]
  • From: Tim Bray <tbray@textuality.com>
  • To: "'xml-dev@ic.ac.uk'" <xml-dev@ic.ac.uk>
  • Date: Wed, 17 Nov 1999 20:45:31 -0800

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






 

News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS