[
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:
http://www.oasis-open.org/cover/xmlLitProg.html
- 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)
|
