docs(release): add hybrid SVN-dist + ATR-vote backend to the release skills#848
Merged
Merged
Conversation
…skills Codify the RM decision to use, while ATR is in alpha, a hybrid release flow: SVN hosts and promotes the artefacts (trusted, ratified) while ATR runs the automated checks and administers the dev@ vote. Previously the backend was a single svnpubsub-or-atr switch; this decouples the two concerns. - release-management-config (magpie + template): add `release_vote_backend` (manual | atr), independent of `release_dist_backend`. Document the hybrid (svnpubsub + atr) and that ATR's Finish/publish is NOT used until the dist backend itself becomes atr. Add `atr_platform_url` to the template. - release-rc-cut: when release_vote_backend = atr, emit an `atr upload` block after the dist-backend staging so ATR has a candidate to check + vote on; never emits an ATR finish/publish while dist = svnpubsub. - release-vote-draft: when atr, emit `atr vote start -m … --subject … --no-auto-publish <project> <version>` (RM runs it; ATR sends + tabulates) instead of a paste-ready email; body still points at the SVN dist/dev URL. - release-vote-tally: when atr, read the tally from `atr vote tabulate`, still classified against the PMC roster. - release-promote: promotion follows release_dist_backend (svn mv), never ATR Finish, regardless of the vote backend. - atr-release-runbook: add a Hybrid-mode callout describing the split. Matched to the installed atr client (0.20260709.x): the vote targets the latest uploaded revision by default (optional --revision), so the docs no longer depend on a `revisions` lookup, and note verb names may shift.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
While ATR is in alpha we don't yet trust it to host or publish releases,
but its automated checks and vote administration are useful now. This
codifies that RM decision as a hybrid backend: SVN hosts + promotes the
artefacts (ratified, trusted); ATR runs the Compose checks and drives the
dev@[VOTE]. Previously the backend was a singlesvnpubsub-or-atrswitch — this decouples "where artefacts live / how they're promoted" from
"who administers the vote."
What
release-management-config.md(magpie + template) — newrelease_vote_backend(manual|atr), independent ofrelease_dist_backend. Documents the hybrid (svnpubsub+atr) andthat ATR's Finish/publish is not used until the dist backend itself
becomes
atr. Addsatr_platform_urlto the template. Magpie is set torelease_dist_backend = svnpubsub,release_vote_backend = atr.release-rc-cut— whenrelease_vote_backend = atr, emits anatr uploadblock after the SVN staging so ATR has a candidate to checkand vote on. Never emits an ATR finish/publish while dist =
svnpubsub.release-vote-draft— emitsatr vote start -m … --subject … --no-auto-publish <project> <version>(RM runs it; ATR sends + tabulates)instead of a paste-ready email; the body still points voters at the SVN
dist/devdownload URL.release-vote-tally— reads the tally fromatr vote tabulate, stillclassified against the PMC roster.
release-promote— promotion followsrelease_dist_backend(
svn mv), never ATR Finish, regardless of the vote backend.atr-release-runbook.md— a Hybrid-mode callout describing the split.CLI accuracy
Matched to the installed
atrclient (0.20260709.x): the vote targets thelatest uploaded revision by default (optional
--revision), so the docs nolonger depend on a
revisionslookup, and note that verb names may shiftbetween ATR releases.