[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

RE: Documenting XML Dialects With Instance Documents

  • To: "Xml-Dev@Lists. Xml. Org (E-mail)" <xml-dev@l...>
  • Subject: RE: Documenting XML Dialects With Instance Documents
  • From: "Doug Ransom" <Doug.Ransom@p...>
  • Date: Tue, 25 Mar 2003 15:11:22 -0800
  • Thread-index: AcLzCJcG2eMQ/fsXQZGP6s5zKiIpnwAGWTuAAAAqx1A=
  • Thread-topic: Documenting XML Dialects With Instance Documents

documenting xml
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
> -- 
> 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>
> > 
> > 


Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
First Name
Last Name
Subscribe in XML format
RSS 2.0
Atom 0.3

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.

Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.