documenting schemas/DTDs

[Tim Bray]

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 at 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 at ic.ac.uk the following message;
unsubscribe xml-dev
To subscribe to the digests, mailto:majordomo at ic.ac.uk the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa at ic.ac.uk)