Seeking standards for documenting XML

Subject: Seeking standards for documenting XML
From: "Ellen Gorlow" <Ellen -dot- Gorlow -at- asg -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 15 Mar 2005 16:38:08 +0100


I am looking for a style guide for documenting XML schemas.

I am wondering how to organize the material.
Should I create separate sections for parent elements, child elements, and attributes?
I have been thinking about using the Microsoft Office 2003 Developer Reference>Microsoft Office 2003 Reference Schemas
as a model.

What do you think? Have any of you run across any other useful resources?

Note: I am not looking for information about using XML as a tool for creating technical documention.

Thanks for any guidance you can give me.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:
http://www.webworks.com/techwr-l

Your Ad Here! Have a product or service you'd like to get some attention for? Use this space to get the word out! Contact lisa -at- techwr-l -dot- com for more details.

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Follow-Ups:

Previous by Author: RE: problem with a link from a web page to an ftp server
Next by Author: Seeking standards for documenting XML
Previous by Thread: Re: Pattern language for tech writing
Next by Thread: Re: Seeking standards for documenting XML


What this post helpful? Share it with friends and colleagues:


Sponsored Ads