Main principles for the versioning of data models in the Data Vocabulary Tool are as follows:
Main principles for the semantic version numbering are as follows:
The contents of the data model can be transferred to another status with the following rules:
Current Status | The new status |
Draft | Suggestion, Valid |
Suggestion | Valid, Retired
|
Valid | Retired, Superseded |
Retired | Superseded, Valid |
Superseded | Retired, Valid |
Name | Description | Code value |
---|---|---|
Draft | The creation of the content has not yet been finished, and the current data model is not ready to be published. The contents can be seen only by the other users of the same organisation than the editor when they have the editing rights to the content. The draft data model does not have a version number. It is a working copy, from which the other versions can be published in the tool as publicly shown snapshots. These published snapshots cannot be edited. However, it is possible to change the status of the published data models. | DRAFT |
Suggested | The data content has been published for comments and it has a version number. The data model with Suggested status also has a public IRI address, i.e. an IRI identifier. However, it is not recommended to add references or links to the data model in Suggested status, because it is likely that the data model will be changed later, and it may never be published as valid. The content creator must decide when the commenting period will end and after that assign the data model either Valid status (changes were not needed) or Retired status (the recommended content was not accepted). The IRI identifier of the data model is reserved for this data model and cannot be further given to any other data model. | SUGGESTED |
Valid | The data model has been published and has a version number. The content is generally used as, for example, a reference by the other data models or linked to the contents in the interoperability platform tools. The IRI identifier of the data model is reserved for this data model and cannot be further given to any other data model. When the content has been published and has the Valid status, it cannot totally be removed from the Data Vocabulary Tool. This will ensure that the links and references will remain valid (the content will remain resolvable). The content can only be changed to Retired status to remove its contents from active use. | VALID |
Superseded | This data content is no longer recommended for use, as it has been superseded with other data content. The IRI identifier of the data model is reserved for this data model and cannot be further given to any other data model. | SUPERSEDED |
Retired | The data content is no longer recommended for use. The data content has not been replaced with other data content. The IRI identifier of the data model is reserved for this data model and cannot be further given to any other data model. | RETIRED |