@@ -34,7 +34,7 @@ the governance below is shared across all repos created that way.
3434- Verify with evidence, not assertions: run the real check for what changed (lint, a full
3535 template/build render, ` actionlint ` for workflows) before calling it done. Green CI is necessary,
3636 not sufficient.
37- - One concern per branch/PR, even tiny ones — it keeps reviews and the drafted changelog clean.
37+ - One concern per branch/PR, even tiny ones — it keeps reviews and the draft release notes clean.
3838- When PRs interact, state an explicit merge ORDER rather than opening them and walking away:
3939 anything a * tag* triggers needs its inputs on ` main ` first; a new * gate* (check) needs the
4040 violations it catches fixed first; a workflow that builds from committed content needs that
@@ -52,26 +52,19 @@ issue with ordered **sub-issues** -> put it on the active **milestone** -> branc
5252(the autolabeler sets the category label from the title), the template body, and a ** closing
5353summary** before merge -> ** squash** merge. The operator (@CryptOS-PKI ) is the assignee.
5454
55- On merge, release-drafter drafts the next notes by label and ` CHANGELOG.md ` updates on ` main ` via the
56- changelog action -- ** nothing tags automatically** . When the first push to main resolves the version,
57- rename the milestone to that version. The maintainer then ** manually publishes the GitHub Release** ,
58- which creates the tag with the finalized changelog (and triggers the publish where the repo ships a
59- package).
55+ On merge, release-drafter drafts the next notes by label -- ** nothing tags automatically** . When
56+ the first push to main resolves the version, rename the milestone to that version. The maintainer
57+ then ** manually publishes the GitHub Release** , which creates the tag with the drafted notes (and
58+ triggers the publish where the repo ships a package).
6059
6160Keep public artifacts (issues, PRs, commit messages) free of references to local-only design notes.
6261
6362## Releasing
6463
65- On every push to ` main ` the ** Release Manager** workflow (` .github/workflows/job-version-bump.yaml ` )
66- runs: release-drafter anticipates the next version, the manifest version is bumped (package
67- ecosystems only), ` CHANGELOG.md ` is updated via the changelog action, and a
68- ` chore(pre-release): vX [skip ci] ` commit is pushed back to ` main ` . ** Nothing tags automatically.**
64+ On every push to ` main ` the ** Release Drafter** workflow (` .github/workflows/release-drafter.yml ` )
65+ drafts the next release notes using the built-in ` GITHUB_TOKEN ` . ** Nothing tags automatically.**
6966The maintainer then publishes the GitHub Release by hand, which creates the ` vX.Y.Z ` tag with the
70- finalized changelog and triggers the publish workflow where the repo ships a package.
71-
72- The Release Manager pushes to ` main ` through the release GitHub App, which the branch ruleset
73- (` governance/rulesets/branch-default.json ` ) lists as a bypass actor — without that bypass the
74- ` [skip ci] ` commit would be rejected by the PR-required rule.
67+ drafted notes and triggers the publish workflow where the repo ships a package.
7568
7669** GitHub Action repos release differently** — a composite/JS action has no package manifest and is
7770** not** published to a registry. The maintainer manually tags ` vX.Y.Z ` , publishes the GitHub
0 commit comments