Skip to content

docs: clarify release communication checkpoints - #259

Merged
tisonkun merged 2 commits into
apache:mainfrom
tisonkun:codex/document-release-human-handoffs
Sep 1, 2026
Merged

docs: clarify release communication checkpoints#259
tisonkun merged 2 commits into
apache:mainfrom
tisonkun:codex/document-release-human-handoffs

Conversation

@tisonkun

@tisonkun tisonkun commented Sep 1, 2026

Copy link
Copy Markdown
Member

Summary

  • define the review, sender, and completion evidence for public release communications
  • apply the same checkpoint model to [VOTE], [CANCEL][VOTE], [RESULT][VOTE], and [ANNOUNCE]
  • require mailing-list thread URLs in the release tracking issue so a prepared draft cannot be mistaken for a completed step

Why

The release guide is shared by release managers and the tools that support them. Public communications need an explicit responsibility and completion boundary, but describing that boundary in terms of agents or automation makes the runbook less natural for human readers.

The revised wording is operational instead: populate each message from verified release state, review its recipients and release-specific values, send it from the release manager's Apache email account, and record the resulting thread URL. These are useful instructions and observable completion criteria regardless of how the draft and supporting evidence were prepared.

This is a rolling documentation improvement and does not change or invalidate the already tagged, published, staged, and verified 0.5.0 RC1 candidate.

Commits

  1. docs: mark release communications as human handoffs
  2. docs: express release communication as checkpoints

Validation

  • cargo x lint
  • git diff --check

Release automation can prepare evidence and message templates, but sending votes, results, and announcements represents the release manager in the Apache community. Make those boundaries explicit so the procedure stops before public communication and hands the reviewed text to the release manager's Apache email account.
Agent-oriented handoff language makes the release guide read like tool instructions rather than a shared operational runbook. Define actor-neutral review, send, and evidence requirements that tell both release managers and supporting tools when each public communication step is complete.
@tisonkun tisonkun changed the title docs: mark release communications as human handoffs docs: clarify release communication checkpoints Sep 1, 2026
@tisonkun
tisonkun merged commit 16ae85e into apache:main Sep 1, 2026
10 checks passed
@tisonkun
tisonkun deleted the codex/document-release-human-handoffs branch September 1, 2026 02:06
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