RE: [xml-dev] Documenting XML Dialects With Instance Documents

["Doug Ransom" <Doug.Ransom@pwrm.com>]

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:dareo@microsoft.com]
> 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:Doug.Ransom@pwrm.com] 
> > 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:doug.ransom@pwrm.com>
> > 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>
> > 
> > 
>