base-layer/commandkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Adopt release policy version 1.6

Browse Source
This commit is contained in:
Eric Rakestraw
2026-10-09 03:48:28 +00:00
parent dacc743551
commit 7eebe877cf
4 changed files with 92 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
docs/release.md
View File

@@ -9,9 +9,9 @@ checksums, or other delivery assets, and it requires no delivery credentials.
Use branch `main`, remote `origin`, and the expected effective push endpoint
`https://gitea.maximumdirect.net/eric/CommandKit.git`. The profile enforces that
endpoint during publication. The maintainer needs a local Go toolchain
compatible with the module's Go 1.25.5 minimum, Git with push access to `origin`,
and a POSIX shell.
endpoint during publication. The maintainer needs the selected
[release toolchain](#release-toolchain), Git with push access to `origin`, and a
POSIX shell.
This procedure follows the [release policy](policy/release.md); the release-note
footer follows the [OSS discoverability policy](policy/oss.md#discoverability).
@@ -25,6 +25,36 @@ command. The upstream [CLI reference](https://gitea.maximumdirect.net/eric/Relea
and [publication guide](https://gitea.maximumdirect.net/eric/ReleaseKit/src/commit/e030794969fb7787e647a90bbc4eb81bd0610f07/docs/consumers/publish.md)
own detailed command, profile, and status contracts.
## Release toolchain
The selected release toolchain is **Go 1.25.5**, matching the current declared
consumer minimum. This keeps candidate validation within the supported Go series.
The [consumer guide](consumers/guide.md#go-compatibility) explains the minimum and
its dependency-based patch requirement; the
[release policy](policy/release.md#consumer-minimum-and-release-toolchain) governs
changes to either selection.
Use this toolchain for candidate validation and the native ReleaseKit bootstrap,
including CI jobs that perform those tasks. The launcher and ReleaseKit invoke
`go` from `PATH` with `GOTOOLCHAIN=local`, so select that installation in the
shell used for preparation and publication.
If it is not installed, use the [standard Go installation method](https://go.dev/doc/manage-install).
Ensure Go's executable installation directory (`GOBIN`, or `GOPATH/bin` by
default) is on `PATH` so the downloaded-version wrapper can be invoked:
```sh
GOWORK=off GOTOOLCHAIN=local go install golang.org/dl/go1.25.5@latest
go1.25.5 download
export PATH="$(go1.25.5 env GOROOT)/bin:$PATH"
hash -r
GOWORK=off GOTOOLCHAIN=local go version
```
The final command should identify Go 1.25.5. An existing Go 1.25.5 installation
may be selected directly on `PATH` instead. Toolchain installation and dependency
preparation precede the offline publication checks; they add no validation pass.
## Prepare and publish a candidate
Choose a fresh, unused stable Semantic Version tag in the form