RE: Documenting XML Dialects With Instance Documents
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@m...] > Sent: Tuesday, March 25, 2003 3:00 PM > To: Doug Ransom; Xml-Dev@Lists. Xml. Org (E-mail) > Subject: RE: 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@p...] > > 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@p...> > > 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> > > > > >
PURCHASE STYLUS STUDIO ONLINE TODAY!
Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!
Download The World's Best XML IDE!
Accelerate XML development with our award-winning XML IDE - Download a free trial today!
Subscribe in XML format