Write the Version Policy
Draft a data contract version policy that maps patch, minor, and major changes to consumer action.
The team has adopted SemVer language but has not defined what patch, minor, and major mean for data contract promises. Data contract SemVer: classify by consumer action required The common trap is copying software SemVer words without declaring the data contract public surface. Then reviewers classify changes by effort, mood, or who is asking. Declare surface Public surface includes fields, meaning, allowed values, grain, quality rules, freshness, support roles, and change notice. Consumers rely on more than column names and types. Patch policy Patch: compatible fixes to implementation or documentation that do not require consumer changes. Patch reassures consumers that…
Sign up free — one personalized lesson every day, matched to your role and goals.
Already have an account? Sign in