VOSI-1.1 Erratum 1 - XML versioning clarification and correctionsAuthor: Brian Major - Grid and Web Services Working Group ChairDate: 28 August 2018 The following Erratum amends the VOSI-1.1 recommendation. RationaleIn VOSI 1.1 (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 (ref), which creates an inconsistency between the schema in the document and what's available in the IVOA XML Schema repository. | ||||||||
Deleted: | ||||||||
< < | 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 (ref). | |||||||
Change of standards text
| ||||||||
Deleted: | ||||||||
< < |
| |||||||
Impact Assessment | ||||||||
Changed: | ||||||||
< < | 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 | ||||||||
Deleted: | ||||||||
< < | ||||||||
VOSI-1.1 Erratum 1 - XML versioning clarification and correctionsAuthor: Brian Major - Grid and Web Services Working Group ChairDate: 28 August 2018 The following Erratum amends the VOSI-1.1 recommendation. Rationale | ||||||||
Changed: | ||||||||
< < | In VOSI 1.1 (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 effect 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. | |||||||
> > | In VOSI 1.1 (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 (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 (ref).
Change of standards text
Impact AssessmentThose 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 |
VOSI-1.1 Erratum 1 - XML versioning clarification and correctionsAuthor: Brian Major - Grid and Web Services Working Group ChairDate: 28 August 2018 The following Erratum amends the VOSI-1.1 recommendation. RationaleIn VOSI 1.1 (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 effect 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 (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 (ref).Change of standards text
Impact AssessmentThose 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 |