[oXygen-user] Commenting and Documenting Customer XML

[Karl Stubsjoen]

Ok, baby steps!
Using Trang Converter, I've created an XML schema from XML source.
The output I chose was W#C XML-Schema (recommendations for other
formats are welcome, I do not know the pros/cons here).  Now I am
going to mark up the schema with xs:documentation and xs:annotation.
Rigth so far?

Ok, how about this.  I have my stylesheet and I have the XML source.
Arbitrarily I have chosen to use a number of the elements in the
stylesheet.  Is it possible to create a USED and NOT USED resource of
elements and attributes from the 2 documents?  So a document outlining
the uses, maybe the count of occurences?  I could write another
transformation to figure this out, er, but if it is built into Oxygen
than that would be great.

Karl..

On Tue, Apr 29, 2008 at 10:30 PM, Karl Stubsjoen <> wrote:
> Hmm... since I am new to Oxygen, I am unfamiliar with the
> possibilities before me.  I am interested in self-embeding
> comments/questions into my clients sample XML, then from this XML
> producing documentation, and possibly a schema which reflects on the
> existing nature of the XML plus the comments which I embed.  The
> xs:documentation and xs:annotation options sound like a great starting
> place!
>
> Thanks, I will keep you posted with my progress.
>
> Karl..
>
>
> On Tue, Apr 29, 2008 at 4:36 PM, seth park <> wrote:
> > Is your purpose to streamline or clarify XML authoring?
> >
> > If so, shema allow for <xs:documentation/> within <xs:annotation/>.
> > Oxygen cues off of this content when authoring (at least in text mode;
> > I dont use author mode). This will define the purpose of certain
> > elements and attributes.
> >
> > For my client, I am creating document templates for their common XML
> > document types. When a user creates a new document, he/she uses a
> > template that has the required elements and comments that describe any
> > options they may have. See the Oxygen help for where to load custom
> > templates.
> >
> > Hope that helps....
> >
> > seth park
> >
>