Skip to content

Commit 66c8a80

Browse files
authored
Merge pull request #43 from cometapi-dev/agent/fix-release-runbook-timing
docs: fix stable release runbook timing
2 parents f782452 + 7d8d79d commit 66c8a80

1 file changed

Lines changed: 14 additions & 14 deletions

File tree

RELEASING.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -232,10 +232,10 @@ then returns non-zero if any violation exists. It must require
232232
`git+https://github.com/cometapi-dev/cometapi-node.git` as `repository.url`, the
233233
same value required by publish validation.
234234

235-
Maintainers perform this transition in the reviewed implementation or
236-
finalization PR before Release Please preparation; the generated release PR
237-
remains limited to its four release files. Validate the exact committed state
238-
with:
235+
Maintainers land this transition in a reviewed implementation or finalization
236+
PR before Release Please preparation. After Release Please creates or refreshes
237+
the generated four-file release PR, validate that PR's exact final committed
238+
state with:
239239

240240
```bash
241241
release_version="$(node -p "require('./package.json').version")"
@@ -535,19 +535,19 @@ and post-action validation; a later `COMMENTED` or `CHANGES_REQUESTED` review,
535535
or any head change, invalidates the approval.
536536
537537
The release-PR merge creates the only `push` run that may call Release Please in
538-
release mode. From that merge through post-action validation, do not edit the
538+
release mode. From that merge through successful registry verification and the
539+
final readback, do not start a new Release Please workflow or rerun any run
540+
except the bounded source-run retry described below; publication freezes the
541+
complete Release Please run set. Through post-action validation, do not edit the
539542
release PR, change its labels or review, or mutate its branch. Keep `main` frozen
540543
at the release commit through successful registry verification and the final
541544
variable and Environment-policy readback; every handoff, tag, and pre-publish
542-
gate requires that exact identity. Do not start or rerun any other Release
543-
Please workflow from the tag handoff through registry verification and final
544-
readback because publication freezes the complete Release Please run set. A
545-
rerun may retry the same release candidate only while no tag or Release exists.
546-
If an earlier attempt of that same run already created the Release, same-run
547-
reconciliation is allowed only after proving the exact run ID, SHA, tag, bot
548-
author, immutable state, target, URL, notes, and publication time inside one
549-
earlier Release Please step. It may only reconcile labels and write the
550-
attempt-qualified result artifact.
545+
gate requires that exact identity. A rerun may retry the same release candidate
546+
only while no tag or Release exists. If an earlier attempt of that same run
547+
already created the Release, same-run reconciliation is allowed only after
548+
proving the exact run ID, SHA, tag, bot author, immutable state, target, URL,
549+
notes, and publication time inside one earlier Release Please step. It may only
550+
reconcile labels and write the attempt-qualified result artifact.
551551
552552
The successful Release Please `workflow_run` enters an unprivileged handoff,
553553
which validates the exact result and immutable Release before dispatching

0 commit comments

Comments
 (0)