Re: documenting schemas/DTDs
With respect to Eliot Kimber's endorsement of literate programming style (applied to SGML/XML applications), and David Megginson's "strong agreement" with Eliot's sentiments: I have collected some references to experience with "Literate Programming with SGML and XML" in: http://www.oasis-open.org/cover/xmlLitProg.html - Robin Cover ----------- On 18 Nov 1999, David Megginson wrote: > "W. Eliot Kimber" <eliot@i...> writes: > > > My personal feeling, based on many years of painful experience > > developing and maintaining DTDs of varying scale and complexity and > > documenting same (including the original version of IBM's IBM ID Doc > > application and the second edition of the HyTime architecture, both > > massive documentation projects) is that the only practical way to > > develop and manage non-trivial document types is by making the > > documentation the primary definition, with the working declarations > > extracted from it using some sort of make process. > > [snip] > > > If you are are creating DTD-syntax DTDs, the syntax of DTDs is simply > > not up to the task of maintaining and managing documentation of any > > useful sophistication. > > I agree very strongly with Eliot, perhaps because we both have a lot > of experience in creating (rather than just processing) user > documentation. [...] 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...)
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