Skip to content

docs(release): runbook R2/R3 match release_prep; changelog headings; dead Coherence link - #244

Merged
chrisdpurcell merged 1 commit into
testingfrom
fixrev1
Sep 1, 2026
Merged

chrisdpurcell merged 1 commit into
testingfrom
fixrev1

Conversation

@chrisdpurcell

Copy link
Copy Markdown
Collaborator

Summary

Repairs from the in-session review of PRs #238–#243: the release runbook's R2 now runs the default release_prep.py bump before --apply-pins, and R3 names the script-owned pin sites from the code and limits hand edits to the judgment sites; the [Unreleased] changelog section has one Added and one Changed heading with cut-successor filed under Added; the dead tests/README.md link to the deleted Coherence workflow now points at Check's ordinary step.

Governing work

Supporting: #236

Acceptance coverage

Verification

Prettier and markdownlint over the full AGENTS.md scope, exit 0 both. No frontmatter touched.

…ANGELOG dupes

R2 previously ran only --apply-pins, a standalone mode that never bumps
pyproject/relocks/converts CHANGELOG (release_prep.py's own docstring:
"a separate mode, not an extra step of the default run"). Add the
default run first, then --apply-pins, matching the code and R7's
claimed commit contents.

R3 still told the operator to hand-bump the four allow-listed pin
files (README/UPGRADING/mcp-server/activation-constant) that
--apply-pins now owns, reinstating the line-number editing hazard
#227 E3 item 5 removed, and never mentioned meta/versioning.md, which
the allow-list also covers. R3 now names the allow-listed sites from
_RELEASE_PIN_SITES/_PACKAGE_PIN_PATH and narrows to the judgment sites
the allow-list deliberately excludes.

CHANGELOG.md [Unreleased] had duplicate sibling ### Changed headings
(MD024 is disabled, so nothing caught it) and filed the new
`standards cut-successor` command under Changed instead of Added.
Merged into one Added and one Changed section, preserving every
bullet.

tests/README.md's CI-relationship bullet still named the deleted
.github/workflows/coherence.yml as a live, separately named status;
#236 C2 folded that coverage into check.yml's ordinary pytest step.
Repointed the prose at that step instead of the dead link.

Refs #227, #236
@chrisdpurcell
chrisdpurcell marked this pull request as ready for review September 1, 2026 20:55
@chrisdpurcell
chrisdpurcell merged commit 83cb4f2 into testing Sep 1, 2026
4 checks passed
@chrisdpurcell
chrisdpurcell deleted the fixrev1 branch September 1, 2026 20:55
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