Skip to content

Commit 3cbe018

Browse files
dmealingclaude
andcommitted
docs(releasing): what moving the tag does to the heavy gates
conformance.yml and integration-tests.yml run on a v* tag and nowhere else. With the tag cut last they now gate the final coordinated tree rather than the npm-only commit — a tree that never shipped. Worth stating, because it is the part of the change that makes it clearly an improvement rather than a rearrangement, and because someone checking whether the move re-triggers a publish needs to know publish-npm.yml keys on npm-v*, not v*. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NynrRND6ZUwGvq3ZUTCfxG
1 parent 5eb7322 commit 3cbe018

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

docs/RELEASING.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -178,6 +178,13 @@ Publish in tier order so a dependent never lands before its dependency. **`forge
178178
out:** `<version>` *is* the npm version, so a mismatch there always means
179179
`bun run site:payload` was not re-run.
180180

181+
**A second effect, and it is an improvement rather than a cost.** `conformance.yml` and
182+
`integration-tests.yml` are the heavy gates that run on a `v*` tag and nowhere else.
183+
Cutting the tag last means they now run against the FINAL coordinated tree — all four
184+
registries bumped, docs refreshed, payload true — instead of the npm-only commit, which
185+
is a tree that never actually shipped. `publish-npm.yml` triggers on `npm-v*`, not `v*`,
186+
so moving the tag does not re-trigger a publish.
187+
181188
## Versioning policy
182189

183190
**The version number's only mechanical meaning today is npm's caret rule.** For

0 commit comments

Comments
 (0)