#21657
The issue of documenting schemas—or any machine readable language—goes beyond simple additions of comments. Thereal challengeistocreateschemasthat arereadablebothdirectlybylookingat their sourcecodeandbydocumentation extraction tools.
van der Vlist, Eric. O'Reilly and Associates (2001). Articles>Information Design>XML>Documentation
#13773
Just Say "Help": Implementing Help in VoiceXML
One of the exciting aspects of XML is the number of ways it is being used to provide new means of communicating and gathering new information. One such use is VoiceXML, an emerging W3C standard that brings voice to the Web or the Web to the phone.
Beebe, Allen. WritersUA (2002). Design>Documentation>XML
#28185
Structured Authoring and XML: Part One
Implementing structured authoring with XML allows organizations to create better content. The addition of hierarchy and metadata to content improves reuse and content management. These benefits, however, must be weighed against the time and money required to implement a structured authoring approach. The business case is compelling for larger writing organizations; they will be the first to adopt structured authoring. Over time, improvements in available tools will reduce the cost of implementing structured authoring and make it affordable for smaller organizations.
O'Keefe, Sarah S. Carolina Communique (2003). Articles>Documentation>Information Design>XML
#28177
Structured Authoring and XML: Part Three
Not every content-creation group will benefit from structured authoring and XML. Sometimes, the expense of implementation outweighs the benefits realized, especially in smaller groups with less total page count.
O'Keefe, Sarah S. Carolina Communique (2004). Articles>Documentation>Information Design>XML
#28186
Structured Authoring and XML: Part Two
In a structured authoring environment, authors create documents by assembling elements and text in an order permitted by the structure definition document. You might think of structured authoring as being similar to template-based authoring with a strict template. Authors do not assign formatting; the formatting is automatically assigned based on the structure of the document. Formatting may differ for different output media.
O'Keefe, Sarah S. Carolina Communique (2003). Articles>Documentation>Information Design>XML
#21709
XML provides a robust, non-proprietary, and verifiable file format for the storage and transmission of text and data both on and off the Web. XML removes the complexity of SGML, making it easier to define your own document types, and to write programs to handle them.
Bokil, Manoj. STC India (2003). Articles>Documentation>Information Design>XML
