{"id":"versioning-standards","title":"Versioning Standards","description":"Conventions for versioning APIs and communicating version information.","standards":[{"id":"semver","name":"Semantic Versioning 2.0.0","title":"Semantic Versioning (SemVer)","description":"Version format: MAJOR.MINOR.PATCH. MAJOR: Breaking changes. MINOR: New features, backwards compatible. PATCH: Bug fixes, backwards compatible. Pre-release and build metadata supported.","url":"https://semver.org/","usedFor":["API versions","info.version field","Breaking change communication"],"format":"MAJOR.MINOR.PATCH","examples":["1.0.0","2.1.0","1.0.0-beta.1","2.0.0-rc.1+build.123"]},{"id":"calver","name":"CalVer","title":"Calendar Versioning","description":"Version format based on release date. Various formats: YYYY.MM.DD, YYYY.MM, YY.MM. Alternative to SemVer, used by some APIs. Good for APIs with regular release cycles.","url":"https://calver.org/","usedFor":["Date-based versions","Regular release cycles"],"examples":["2024-01-15","2024.01","24.1"]}],"links":{"self":{"href":"/v1/standards/versioning-standards"},"parent":{"href":"/v1/standards"}}}