Skip to content

chore: refine the release skill after the 0.7.3 release - #338

Merged
tisonkun merged 2 commits into
apache:mainfrom
orthur2:docs/release-skill-gaps
Oct 1, 2026
Merged

tisonkun merged 2 commits into
apache:mainfrom
orthur2:docs/release-skill-gaps

Conversation

@orthur2

@orthur2 orthur2 commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Refine the release skill with what the 0.7.3 release run showed, tracked in #327.

  • Say how a new release manager's public key reaches KEYS, since ATR imports the committee's keys from the distribution area rather than accepting an upload.
  • Describe both release environment approvals, for composition and for the final tag, as actions for a reviewer listed in .asf.yaml, which the release manager performs only when listed there.
  • State the plain-text conventions for vote messages, since mailing lists do not render Markdown.
  • Tell the release manager to cast their own vote on ATR or in the thread, since a release manager has no implicit +1 under the ASF voting process.
  • Note that ATR renders the second round's message from the stored template, so candidate details written by hand in the first round do not carry over.
  • Note that ATR neither resolves an email vote nor sends a reminder when it ends.
  • Add updating the website Downloads page before the announcement, in the runbook and the tracking issue checklist, which the 0.7.2 and 0.7.3 releases both needed.
  • Add the rerun recovery path for a failure caused outside the repository: the composed bundle is reused, a reviewer approves again, and GitHub accepts reruns for 30 days.

Validation: cargo x lint.

Comment thread .agents/skills/release/references/infrastructure.md Outdated
Comment on lines +30 to +31
3. Review the generated subject and body. Identify Apache Asyncband (Incubating), `${VERSION}`, and the RC; include the ATR candidate/revision, RC tag and commit, source checksum, KEYS and signer information, changelog, and verification evidence. Link ATR as the location of the voted files. Write the body as plain text for the mailing lists: no Markdown or backticks, prose wrapped near 72 characters, each label and its URL on separate lines, and no line break inside a word or checksum. Submit **Send vote email** when sending the vote is authorized, then record its archive link and closing time.
4. Cast your own first-round vote with the checks you performed, either on the ATR vote page or by replying in the thread. A release manager has no implicit `+1`, so only an explicit vote counts towards the round. See the [ASF voting process](https://www.apache.org/foundation/voting.html).

@tisonkun tisonkun Sep 29, 2026 •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we may try to see if ATR supports defining the email template as code instead of defining it on the platform. Then we can keep the email template in our repository. Then we don't need Point 3 at all, but that can be a follow-up to investigate.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed. And I took a look at the ATR code. Its "Export .asf.yaml" already writes start_vote_template, start_vote_subject, announce_release_template and a few other template fields under project.policy, so it seems we could keep the templates in our .asf.yaml, since we already have atr_sync on. I haven't checked yet whether the asfyaml side accepts those keys. I'll look into how to optimize this part later.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can be a follow-up PR that we review separately BTW.

@tisonkun tisonkun left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rest generally looks good.

@orthur2

orthur2 commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor Author

Thanks for the review, I'll update this draft PR later.

@orthur2
orthur2 marked this pull request as ready for review October 1, 2026 00:32

@tisonkun tisonkun left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Merging ...

Follow-ups can be handled later, or you may open an issue to track if you are not processing it now.

@tisonkun
tisonkun merged commit d7b658f into apache:main Oct 1, 2026
9 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.

2 participants