From 1c85ad8c1bf9b63c28c3940304283ebe9b5a4106 Mon Sep 17 00:00:00 2001 From: void <1711810+taraxvoid@users.noreply.github.com> Date: Sun, 11 Oct 2026 22:25:07 -0700 Subject: [PATCH] docs(release): explain the missed-feat patch bump after promotion and the Release-As fix Co-Authored-By: Claude Opus 5.5 --- RELEASING.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/RELEASING.md b/RELEASING.md index 62a92cc..c50ebf6 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -45,6 +45,14 @@ gitGraph never squash: a squash leaves main's commits out of next's history, so the following back-merge conflicts on the same lines again. +Check the stable release PR's version before merging it. release-please walks +`main` newest-first by commit date and stops at the last release commit, so a +`feat` on `next` dated before the latest stable release (e.g. a hotfix released +while the feature waited on `next`) is never counted and the PR proposes a +patch bump. Fix it with a squash-merged PR to `main` whose body ends with a +`Release-As: X.Y.Z` footer (the squash commit message is the PR body), then +add the missed entries to the release PR's `CHANGELOG.md` by hand. + ## Hotfix Fix on a branch off `main`, PR to `main`, squash-merge, release as above. The