Skip to content

docs(release-management): add ATR (Apache Trusted Releases) runbook#711

Merged
potiuk merged 1 commit into
apache:mainfrom
potiuk:docs/atr-release-runbook
Jul 3, 2026
Merged

docs(release-management): add ATR (Apache Trusted Releases) runbook#711
potiuk merged 1 commit into
apache:mainfrom
potiuk:docs/atr-release-runbook

Conversation

@potiuk

@potiuk potiuk commented Jul 3, 2026

Copy link
Copy Markdown
Member

What

Adds an ATR (Apache Trusted Releases) release runbook as the
counterpart to the existing svnpubsub runbook, so the
release-management docs cover the ATR distribution backend end to end.

New file docs/release-management/atr-release-runbook.md documents the
same 14-step lifecycle, driven by
the same release-* skills, but against the ATR platform. ATR replaces
the mechanics of Steps 5–11 with its three phases:

  • Compose (Steps 4–6) — build + sign locally, upload to ATR; ATR
    runs signature/checksum/license/notice/source-header checks on upload.
  • Vote (Steps 7–9) — ATR sends the [VOTE] to dev@ and tabulates
    over the ≥72h window; release-vote-tally cross-checks against the
    PMC roster.
  • Finish (Steps 10–11) — strips -rcN, publishes to
    dist.apache.org, assists the [ANNOUNCE].

Also included: atr client 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

  • Registers atr as a release_dist_backend value in the adopter
    config template, with an explanatory note.
  • Cross-links the new runbook from the family README and the
    svnpubsub runbook.

Notes

  • ATR is flagged alpha throughout (alpha deployment
    release-test.apache.org; prod host release.apache.org). The
    svnpubsub runbook remains the ratified default until a PMC ratifies
    ATR; exact atr client verbs are marked "confirm with atr --help"
    since the client schema isn't stable yet.
  • Docs-only change. markdownlint, typos, lychee, and doctoc
    all pass.
  • Does not yet thread ATR command shapes through process.md's
    backend table or spec.md's per-skill sections — kept proportionate
    to a runbook; happy to follow up if wanted.

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.
@potiuk potiuk merged commit 407792c into apache:main Jul 3, 2026
34 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant