Adopt the updated standard repository policies

This commit is contained in:
2026-11-17 19:56:32 +00:00
parent 8afb49c018
commit 381668568f
10 changed files with 119 additions and 40 deletions

View File

@@ -7,16 +7,18 @@ The source release completes when the intended tag is successfully pushed to
## Prepare the candidate
Use `main` and the authoritative Git remote `origin`. Install Git, a POSIX
shell, standard Unix build tools, and Go 1.26. Have the selected Go modules
available before offline validation. Git access must permit fetch and tag push.
shell, standard Unix build tools, and the [release toolchain](#release-toolchain).
Have the selected Go modules available before offline validation. Git access
must permit fetch and tag push.
Application-provider credentials are not required; Gitea delivery credentials
belong to CI.
Choose an unused stable `vMAJOR.MINOR.PATCH` under the
[compatibility rules](policy/release.md#versioning-and-compatibility). Narratio
is past v1.0.0, so intentional CLI or configuration breaks require a major
release. Update affected canonical documentation with the change. Write the
matching `docs/releases/vMAJOR.MINOR.PATCH.md` with a short summary and any
is past v1.0.0; apply the policy's effective-configuration compatibility
definition and Go consumer-minimum exception. Update affected canonical
documentation with the change. Write the matching
`docs/releases/vMAJOR.MINOR.PATCH.md` with a short summary and any
relevant compatibility impact or upgrade action; choose sections to suit the
release.
@@ -39,6 +41,27 @@ before tagging; record its exact commit if needed:
git rev-parse HEAD
```
## Release toolchain
The selected release toolchain is Go 1.26.7, matching the validation and build
jobs in `.woodpecker/release.yml`. With an official Go installation available,
select it before candidate validation and publication:
```sh
export GOTOOLCHAIN=go1.26.7
go version
```
Go downloads the selected toolchain if needed. Complete that setup and module
preparation before offline candidate validation. Keep this selection and the
release CI images aligned when deliberately updating the release toolchain.
The consumer minimum remains Go 1.26.0 as declared in `go.mod`.
Successful release validation on the selected patch establishes presumed
support across that series, subject to the declared minimum and concrete
evidence of incompatibility, under the
[release policy](policy/release.md#consumer-minimum-and-release-toolchain).
## Publish
From a clean `main` checkout at the pushed candidate, run one command: