(r2) VOSI-1_1-Err-1 < IVOA

IVOA Web>IvoaGridAndWebServices>VOSI-1_1-Errata>VOSI-1_1-Err-1 (revision 2) (raw view)~~EditAttach~~

---++ !VOSI-1.1 Erratum 1 - XML versioning clarification and corrections

Author: Brian Major - Grid and Web Services Working Group Chair<br />Date: 28 August 2018

The following Erratum amends the VOSI-1.1 recommendation.

---+++ Rationale

In VOSI 1.1 ([[#Ref1][ref]]), the VOSITables schema was modified so that _table_ elements could themselves be root documents. Aside from some text cleanup, this was the only change that would affect services and clients using VOSI. The namespace of the VOSITables schema remained at version 1.0 and the minor version of the schema was stated in the _version_ attribute of the schema and set to 1.1.

However, the two other schemas defined in this standard (VOSICapabilities and VOSIAvailability) also had their minor version incremented to 1.1, even though they did not change. These schemas were (correctly) not uploaded to the IVOA XML Schema repository ([[#Ref2][ref]]), which creates an inconsistency between the schema in the document and what's available in the IVOA XML Schema repository.

The 1.1 VOSITables schema, which did change, was (correctly) uploaded to the IVOA XML Schema repository. However, since the namespace did not change, it should have replaced the existing VOSITables 1.0 schema instead of being a new and separate schema document. This process of updating the schema on minor schema changes is in accordance to the recommendations of the XML Schema Versioning Policies ([[#Ref3][ref]]).

---+++ Change of standards text

   * Appendix A: _The Complete VOSICapabilities Schema_: The value of the _version_ attribute in root definition should be *1.0*, not 1.1
   * Appendix B: _The Complete VOSIAvailability Schema_: The value of the _version_ attribute in root definition should be *1.0*, not 1.1
   * The IVOA XML Schema repository should should only have one XSD for VOSI which is labelled *1.0* and should match exactly the content of the schema defined in Appendix C: _The Complete VOSITables Schema_.

---+++ Impact Assessment

Those implementing VOSI 1.1 would find it confusing to see the inconsistencies between the schema defined in the standard and the schema published in the XML schema repository.

---+++ References

<a name="Ref1"></a>
   * [[http://ivoa.net/documents/VOSI/20170524/index.html][VOSI 1.1]]
<a name="Ref2"></a>
   * [[http://ivoa.net/xml/index.html][IVOA XML Schema repository]]
<a name="Ref3"></a>
   * [[http://ivoa.net/documents/Notes/XMLVers/index.html][XML Schema Versioning Policies]]

Topic revision: r2 - 2018-08-29 - MarkTaylor

IVOA

Log in or Register

IVOA.net
Wiki Home
WebChanges
WebTopicList
WebStatistics

Twiki Meta & Help
IVOA
Know
Main
Sandbox
TWiki

TWiki intro
TWiki tutorial
User registration
Notify me

Working Groups

Interest Groups

Committees

Stds&Procs

www.ivoa.net
Documents
Events
Members
XML Schema