I am thinking more along the lines of our RDDL documentation. We will publish schemas on the rddl page, and publish a sample instance document for illustrative purposes. There is a bit of a semantic gap for the reader between the schemas and instance document. Examplotron isn't quite what I have in mind (and it targets Relax, while we prefer XML Schema & Schematron). What I am looking for is a reusable way to create annotated instance documents. As the user navigates the annotated document they see schema rules which apply and some natural language documentation as well.
I could see implementing this as a document which has pointers to or fragments of the instance document and pointers to the relevant schemas bits.
> -----Original Message-----
> From: Dare Obasanjo [mailto:]
> Sent: Tuesday, March 25, 2003 3:00 PM
> To: Doug Ransom; Xml-Dev@Lists. Xml. Org (E-mail)
> Subject: RE: [xml-dev] Documenting XML Dialects With Instance
> Documents
>
>
> Inline Schema?
>
> http://msdn.microsoft.com/library/en-us/cpguide/html/cpconvali
> dationwith
> inlinexsdschema.asp
>
> --
> PITHY WORDS OF WISDOM
> You can never tell which way the train went by looking at the track.
>
>
> This posting is provided "AS IS" with no warranties, and confers no
> rights.
>
> >
> >
> > -----Original Message-----
> > From: Doug Ransom [mailto:]
> > Sent: Tuesday, March 25, 2003 11:56 AM
> > To: Xml-Dev@Lists. Xml. Org (E-mail)
> >
> > Does anyone know of useful tools or techniques to annotate an
> > instance document WRT its Schemas (typically both an XML
> > Schema and Schematron in our case)? I think people like to
> > look at the instance document and see the relevant bits of
> > the schemas than the other way around, perhaps in a frame
> > beside the instance document.
> >
> >
> >
> > Doug Ransom
> > Interoperability Architect
> > Power Measurement
> > 2195 Keating X Road
> > Saanichton, BC, Canada V8M 2A5
> > Tel: 1-(250) 652-7100
> > E-Mail: <mailto:>
> > Website: <http://www.pwrm.com/>
> >
> > ION(r) smart energy everywhere(tm)
> >
> >
> > -----------------------------------------------------------------
> > The xml-dev list is sponsored by XML.org
> > <http://www.xml.org>, an initiative of OASIS
> > <http://www.oasis-open.org>
> >
> > The list archives are at http://lists.xml.org/archives/xml-dev/
> >
> > To subscribe or unsubscribe from this list use the subscription
> > manager: <http://lists.xml.org/ob/adm.pl>
> >
> >
>
