TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:RE: Documenting an XML format -- how much detail? From:"France Baril" <France -dot- Baril -at- ixiasoft -dot- com> To:"Goober Writer" <gooberwriter -at- yahoo -dot- com>, "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 15 Jan 2004 11:51:40 -0500
Self documenting? I'd have to strongly disagree with you. When you have
many schemas or DTD to work with, it becomes hard to understand what the
purpose of each element is. I do not consider myself a newbie anymore,
and I must say that very often I spend a lot of time trying to figure
out the purpose of some schema or DTD elements, especially with large
DTDs or schemas.
