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

Re: documenting schemas/DTDs

• From: Robin Cover <robin@i...>
• To: XML Dev <xml-dev@i...>
• 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:

   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...)

• References:
  • Re: documenting schemas/DTDs
    • From: David Megginson <david@m...>

• Prev by Date: Re: SML: The size of the processor is not the issue
• Next by Date: Re: Why validate? (was Re: Parser compliance)
• Previous by thread: Re: documenting schemas/DTDs
• Next by thread: Re: documenting schemas/DTDs
• Index(es):
  • Date
  • Thread