Extend the extension and vocabulary schemas with version attribute

17555
Reporter: kbraak
Assignee: kbraak
Type: NewFeature
Summary: Extend the extension and vocabulary schemas with version attribute
Priority: Major
Resolution: Fixed
Status: Closed
Created: 2015-04-22 16:56:23.409
Updated: 2016-05-10 15:19:56.529
Resolved: 2015-08-28 11:51:50.69
        
Description: The [extension schema|http://rs.gbif.org/schema/extension.xsd] and [vocabulary schema|http://rs.gbif.org/schema/thesaurus.xsd] need to be extended by adding a version attribute that takes a date.

Since the version is a date, we could use [dc:issued|http://dublincore.org/documents/dcmi-terms/#terms-issued]. ]]>
    

Author: kbraak@gbif.org
Created: 2015-04-30 14:05:09.39
Updated: 2015-04-30 14:12:46.101
        
The Dublin Core schema had to be modified first, and a new version of this schema (http://rs.gbif.org/sandbox/schema/dc.xsd) has been added to the sandbox.

The change to dc.xsd involved changing dc:issued type from xs:datetime to xs:date. The dc:issued date is what will ultimately be used to version extensions and vocabularies.

The dc:issued attribute was then added to the  and  definitions in the new versions of the http://rs.gbif.org/sandbox/schema/extension.xsd and http://rs.gbif.org/sandbox/schema/thesaurus.xsd files also added to the sandbox. Please note that dc:issued is a required field in these new schemas.

Fortunately dc:issued was never used in any existing extension or vocabulary. Moving to production, we'll have to be careful to version dc.xsd and call it something else, or be forced to update all extensions and vocabularies with an issued date since this term is required.

The changes can be seen in this commit: https://github.com/gbif/rs.gbif.org/commit/f18faaa0fbdc035d173429fa072e65b3c866e5b0
    

Author: kbraak@gbif.org
Comment: All that remains left to do, is to move the new dc.xsd, extension.xsd, and thesaurus.xsd sandbox schemas to production, and to make sure any references to them are updated accordingly. It is strongly advised we version these schemas, e.g. dc-2014-05-24.xsd.
Created: 2015-04-30 14:15:11.643
Updated: 2015-04-30 14:17:14.426

Author: kbraak@gbif.org
Created: 2015-08-28 11:51:50.764
Updated: 2015-08-28 11:51:50.764
        
We decided it was optimal to try and maintain a single version of our extension.xsd, thesaurus.xsd, and dc.xsd files.

Therefore the changes in the sandbox were merged into production, and all extensions and vocabularies were updated so that they still validate against the updated xsds.

Closing issue