diff --git a/CHANGELOG.md b/CHANGELOG.md index 063ce0c..fe920b2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,7 +7,7 @@ Keep a Changelog change-type headings, so a consumer reads only the sections that affect its template. Version numbers follow the `MAJOR.MINOR.PATCH` policy described in [the README](README.md#versioning). -## Unreleased +## [0.2.0] - 2026-08-08 ### manual @@ -182,4 +182,5 @@ sections that affect its template. Version numbers follow the - Added release workflow to create GitHub Releases from tags using CHANGELOG.md. +[0.2.0]: https://github.com/aicers/docs-theme/tree/0.2.0 [0.1.0]: https://github.com/aicers/docs-theme/tree/0.1.0 diff --git a/README.md b/README.md index 1bc7551..a3ba378 100644 --- a/README.md +++ b/README.md @@ -143,6 +143,11 @@ Templates are **not** versioned separately: one repository version covers all of them, and the vendored diff in a consumer's bump pull request shows whether that consumer is actually affected. +While the version is below `1.0.0`, a breaking change bumps MINOR rather +than MAJOR, and everything else bumps PATCH. The project stays on `0.x` +until the contract above has been proven by consumers actually adopting +it. + A release is only meaningful when the installed surface actually changed. The release workflow rejects a tag whose release surface — everything `fetch-theme.sh` installs, plus `fetch-theme.sh` itself — is byte-identical