swift-codex-openapi-kernel.git · VERSIONING.md

swift-codex-openapi-kernel.git / VERSIONING.md

revision 0f6fe4929b1373075c88eca8cca8342734a43b03 · complete file

# Versioning Policy

FountainAI services and the OpenAPI generator follow [Semantic Versioning](https://semver.org/).

- **API directories** under `FountainAi/openAPI/v<major>/` indicate the public **major** version.
- Breaking API changes create a new `v<major>` directory.
- Within a major version, backwards‑compatible additions bump the **minor** version.
- Bug fixes and documentation updates bump the **patch** version.

Every change to an API spec or the generator must be recorded in `CHANGELOG.md` with the corresponding version number.