Semantic Versioning
MAJOR.MINOR.PATCH tells users whether an upgrade can break them — but only if what counts as the public interface was declared first. That applies to data, too.
-
-
Deprecation
A deprecated interface may keep working without a fixed removal date. Explain the support policy and, when retiring it, provide a migration plan.
-
Data Model Change and Compatibility
The dangerous model change is the one that passes every check. See what breaks consumers, why meaning changes are invisible, and how to publish one safely.
-
Naming Convention
Learn what makes a file name searchable and sortable, why dates belong in ISO order, and how one authoritative copy prevents version confusion.