[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] Documenting DTD's
I just spent a half hour listening to our docs/help person complain about the uselessness of generating documents containing english language descriptions of elements defined in DTDs. As soon as she writes the stuff it's obsolete or vague, and why should she be a middlewoman adding little additional real value between the DTD writer and the DTD consumer, etc. So, two questions for the list: a) is there a javadoc-like standard for adding comments to DTDs and a set of tools out there for extracting them and, better, b) is there a tool out there that will read a DTD and produce a decent picture of the elements and their relationships? I'm sure there must be something out there we could leverage before we roll our own... b PS And of course I'm interested in anyone's experience/thoughts on generating and maintaining useful documentation for DTDs.
|
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
|