OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index]
RE: XML Schema 1.1 Best Practice

Okay Roger here is one Best Practice to start with...  
Best Practice:  Create Structured Annotations

Why:  It makes it easier to apply certain style sheets, cleaner way to document and verify information, enables improved search capabilities, etc.

Recommendation:  Provide an XML Schema which documents and validates your structured annotations.  If you choose to add this idea to the Best Practices, I also recommend we add an example. I recall attempting to insert the xs:schema tag statement which would link the current schema to the structured annotation schema for validation purposes to be a bit challenging. It might help readers if we provided a working example.
Does anyone know of a standard which is designed as generic structured documentation?  If there is one, is it extendable?  I was in a few program where they each created their own structured annotation schemas (of course style sheets couldn't easily be reused)...I could provide a sample structured documentation schema for the Best Practices if you like.  Some terms found in that schema, although I'm sure I'm forgetting something, are found below:
-Full Name
-References (i.e. ISO 6133 trigraph)
-Omission (i.e. if this element is missing what does that mean? In the case of Altitude does this mean an Altitude is unknown or there is no Altitude?)
I believe there was also a way of specifying if an element was being deprecated, but I’d have to look that up.  Comments?


From: Costello, Roger L.
Sent: Thursday, November 11, 2010 9:40 AM
To: Utzinger, Melissa L.
Subject: RE: XML Schema 1.1 Best Practice

Hi Melissa,

     Either version!


-----Original Message-----
From: Utzinger, Melissa L.
Sent: Thursday, November 11, 2010 9:32 AM
To: Costello, Roger L.
Subject: RE: XML Schema 1.1 Best Practice


Do they have to be specific to XML version 1.1 or to either versions?


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index]

News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 1993-2007 XML.org. This site is hosted by OASIS