Describe rules for schema versioning

[dalito]

HCA schema versioning guidelines could serve as example.

[markdoerr]

Yes, the HCA versioning provides a good template - from what I see, we could copy it 1:1

[dalito]

SchemaVer proposed in a snowplow blog post also matches with the HCA scheme and is also adapted by openlinaeage.

SchemaVer: Given a version number MODEL-REVISION-ADDITION, increment the:

• MODEL when you make a breaking schema change which will prevent interaction with any historical data
• REVISION when you make a schema change which may prevent interaction with some historical data
• ADDITION when you make a schema change that is compatible with all historical data