XTCE11 — proposed schema change for documentation issue

JPL MER & JWST schemas have numerous ways to capture various types of documentation – these include but are not limited to developer information, flight software information, document info and so forth. At this time XTCE has a LongDescription and ShortDescription and a few specialized areas of documentation – that are simply not sufficient to capture the full scope of info held in the other schemas. While it would be nice to specifically put elements into XTCE to allow the capture of this information in a formal way, there is at this time no agreement on what that would exactly be.

Most of the information in question is of the form "tag: data" – where the tag is simply the label for the data – such as "Developer: T.Hacker". As such a simpler solution at the moment would be to extend the XTCE LongDescription to be unbounded and add an attribute to it to hold the tag information. Because this element is part of a base type in XTCE used by most of the major types – it will give users a large number of areas in which to capture their varied documentation. In time as agreement is reached on specific types of documentation, the schema can be extended more formally..

— Proposed Schema change to XTCE —

<element name="LongDescription" minOccurs="0" maxOccurs="unbounded">

<annotation>

<documentation>The Long Description is intended to be used for explanitory descriptions of the object and may include HTML markup. Long Decriptions are of unbounded length. Multiple long descriptions may be used to hold tagged information.</documentation>

</annotation>

<complexType>

<simpleContent>

<extension base="string">

<attribute name="name" type="string"/>

</extension>

</simpleContent>

</complexType>

</element>

No Data Available