docs(release-management): add ATR (Apache Trusted Releases) runbook#711
Merged
Conversation
Add an ATR-backend release runbook as the counterpart to the existing svnpubsub runbook. Same 14-step lifecycle and same release-* skills; ATR replaces the mechanics of Steps 5-11 (Compose -> Vote -> Finish). - docs/release-management/atr-release-runbook.md: phase-by-phase flow, atr client setup, the two state-change boundaries on the ATR backend, a GitHub Actions/OIDC path, and an RM checklist. - Register `atr` as a release_dist_backend value in the adopter config template, with an explanatory note. - Cross-link from the family README and the svnpubsub runbook. ATR is flagged alpha throughout; svnpubsub remains the ratified default until a PMC ratifies ATR.
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.
What
Adds an ATR (Apache Trusted Releases) release runbook as the
counterpart to the existing
svnpubsubrunbook, so therelease-management docs cover the ATR distribution backend end to end.
New file
docs/release-management/atr-release-runbook.mddocuments thesame 14-step lifecycle, driven by
the same
release-*skills, but against the ATR platform. ATR replacesthe mechanics of Steps 5–11 with its three phases:
runs signature/checksum/license/notice/source-header checks on upload.
[VOTE]todev@and tabulatesover the ≥72h window;
release-vote-tallycross-checks against thePMC roster.
-rcN, publishes todist.apache.org, assists the[ANNOUNCE].Also included:
atrclient setup, the two state-change boundaries(agent never holds the signing key, never publishes) on the ATR
backend, a GitHub Actions/OIDC compose path, and an RM checklist.
Also
atras arelease_dist_backendvalue in the adopterconfig template, with an explanatory note.
svnpubsubrunbook.Notes
release-test.apache.org; prod hostrelease.apache.org). Thesvnpubsubrunbook remains the ratified default until a PMC ratifiesATR; exact
atrclient verbs are marked "confirm withatr --help"since the client schema isn't stable yet.
markdownlint,typos,lychee, anddoctocall pass.
process.md'sbackend table or
spec.md's per-skill sections — kept proportionateto a runbook; happy to follow up if wanted.