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: Robin Cover <robin@isogen.com>
  • To: XML Dev <xml-dev@ic.ac.uk>
  • Date: Thu, 18 Nov 1999 06:59:32 -0600 (CST)

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:


- Robin Cover


On 18 Nov 1999, David Megginson wrote:

> "W. Eliot Kimber" <eliot@isogen.com> 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@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