Question: Data Definition Schema Versioning
The Manifest Ingestion effort is leveraging the latest schema definitions coming from the Data Definitions team. The present repo contains the JSON schema definitions with each definition file containing a -1.0.0.json
suffix. Presently, updates to these schema definitions are pushed to the master
branch, but the 1.0.0
semantic version number is not updated.
We believe this is due to the fact that the 1.0.0
version is not yet officially released (think SNAPSHOT
s for Maven). As such, we have three questions to help us better plan development work:
- Is there a central place where changes to the schema definitions for each push to
master
are captured? Something behind the pull request notes? - Is there a cut-off date for JSON schema definition changes for Release 3? Meaning, where future changes are rolled into a 3.x or a 4.x OSDU release? We ask to ensure we minimize code changes for the manifest ingestion effort.
- After the official
1.0.0
release of the JSON schema definitions, will future changes follow semantic versioning as updates are pushed to the master branch? It would be helpful if each push to the master branch corresponded to a semantic version increase.