docs: document the dev/beta/main release lifecycle
CLAUDE.md and docs/release-channels.md now describe the full cycle: work lands on feature/fix branches merged into dev, dev auto-publishes on every push, beta is cut from dev as a frozen stabilization branch (also auto-publishing on every push, fixes forwarded from fix/<issue> branches), and after a quiet freeze period beta merges to main and gets tagged for the actual stable release. Also fixes README's stale reference to .github/workflows (actual CI lives under .forgejo/workflows) and links out to the new CONTRIBUTING.md.
This commit is contained in:
parent
2b05a4f6c2
commit
0425c64214
3 changed files with 55 additions and 18 deletions
10
README.md
10
README.md
|
|
@ -123,8 +123,8 @@ bread-ecosystem/
|
|||
|
||||
## Release pipeline
|
||||
|
||||
Each product repo (`Breadway/bread`, `Breadway/breadbar`, …) has a
|
||||
`.github/workflows/release.yml` that triggers on `v*` tags. The workflow
|
||||
Each product repo (`Breadway/bread`, `Breadway/breadbar`, …) has
|
||||
`.forgejo/workflows/release-*.yml` that triggers on `v*` tags. The workflow
|
||||
runs on a self-hosted runner on hestia, builds a stripped x86_64 binary,
|
||||
deposits it at `dl.breadway.dev/<pkg>/<version>/`, updates `index.json`,
|
||||
and mirrors the binary to GitHub Releases as a fallback.
|
||||
|
|
@ -132,6 +132,12 @@ and mirrors the binary to GitHub Releases as a fallback.
|
|||
`bakery` always tries `dl.breadway.dev` first and transparently falls back
|
||||
to the GitHub Release URL recorded in the manifest.
|
||||
|
||||
Beyond stable releases, most products also publish **dev** and **beta**
|
||||
tracks — continuous builds off the `dev` and `beta` branches, respectively.
|
||||
See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the branch/release workflow and
|
||||
[`docs/release-channels.md`](docs/release-channels.md) for the full track
|
||||
policy. Switch tracks with `bakery track set <stable|beta|dev>`.
|
||||
|
||||
### Release artifact contract
|
||||
|
||||
Each product's `release.yml` **must** upload the following files alongside
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue