Skip to content

Commit 495fa21

Browse files
dmealingclaude
andcommitted
docs(releasing): add step 0 — scan for unmerged work before cutting
0.21.1 shipped without a timestampMode fix that already existed on an unmerged branch, forcing a full coordinated 0.21.2 within the hour. Versions are immutable on all four registries and the single shared patch number means an omission costs four publishes, not one, so the `--no-merged` scan belongs ahead of the CHANGELOG rather than nowhere. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KTGT5ksntpcJDZVJ5VyXHS
1 parent 4bdde5b commit 495fa21

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

docs/RELEASING.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,23 @@
2020
> (identical content at the new version) rather than sitting the release out. The rest of this doc
2121
> is the per-registry procedure.
2222
23+
## Step 0 (all registries): scan for unmerged work before you cut
24+
25+
Run this **first**, before the CHANGELOG is even written:
26+
27+
```bash
28+
git fetch origin -q && git branch -a --no-merged origin/main
29+
```
30+
31+
Decide explicitly for every branch the scan returns: merge it into this cut, or state why it waits.
32+
Do not skip past the list.
33+
34+
**Why this is step 0 and not a nicety:** `0.21.1` shipped *without* a `timestampMode` fix that was
35+
already written and sitting on an unmerged branch. Because versions are immutable on all four
36+
registries, the only correction was a full coordinated `0.21.2` within the hour — four publishes, an
37+
~11-minute Maven deploy, and a second round of adopter notification, to ship work that already
38+
existed. The single shared patch number makes an omission cost four publishes, not one.
39+
2340
## Releasing the TypeScript packages to npm
2441

2542
How to publish the `@metaobjectsdev/*` TypeScript packages. Read the **Golden rules** first —

0 commit comments

Comments
 (0)