Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions docs/releasing.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,3 +29,13 @@ Two kinds of tags, both on the same release commit:

For a docs/non-release change that should reach `@v1` callers without a new
version, just move the major tag: `git tag -f v1 HEAD && git push -f origin v1`.

## Exceptions

- **`v1.0.1` was amended after publishing (2026-06-15).** It shipped with a
regression that made `update-flake` PRs land a placeholder commit message
(`[create-pull-request] automated change`). Because adoption was negligible,
the fix was force-pushed onto the existing `v1.0.1` and `v1` tags instead of
cutting a `v1.0.2`. This is a deliberate one-off departure from the immutable
`vX.Y.Z` rule above; don't treat it as precedent for moving published patch
tags once a release has real users.