Document:
Proposed Approach to Schema Type Documentation.pdf

Draft (A preliminary unapproved sketch, outline, or version.)

Details

Submitted By Toby Considine on 2011-06-03 5:39 pm UTC

Publication Type

None at this time.

Group / Folder

OASIS Energy Market Information Exchange (eMIX) TC / Contributions

Modified by

Not modified.

Copy

This document is not a copy.

Technical Contact

None at this time.

Download Count

209

Download Agreement

None at this time.

Description

The documentation of elements in PR02 does not properly reflect the approach to inheritance taken by the TC, and so ends up duplicating defintions, including possibly forking or redfining elements.

This document illustrates an approach to documentation of the schemas in the specification that could reduce duplication while more accurately reflecting the underlying structure.

Please look at this quickly, and send a thumbs up or thumbs down, perhaps with a qualification (would be better if....) to the list. If the TC likes this approach, the editor will use it this weekend...

Note that this is not a technical document, but a style decision. You should be able to review and comment in minutes. Any technical variance between this and other revs is purely accidental, as I am not addressing those issues herein.