From 98797658ae281a5ac552371cd7e76bc8204cd836 Mon Sep 17 00:00:00 2001 From: Sebastian Mendel Date: Sat, 4 Jul 2026 18:12:58 +0200 Subject: [PATCH] docs(release-process): bump CHANGELOG footer link-refs, not just the heading Keep-a-Changelog footer compare-links drift silently: repoint [Unreleased] to vNEW...HEAD and add [vNEW]: compare/vPREV...vNEW when cutting a release, else a reviewer bot flags the dangling [Unreleased]: ref (and a prior version's link may be missing entirely). Signed-off-by: Sebastian Mendel --- skills/github-release/references/release-process.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/skills/github-release/references/release-process.md b/skills/github-release/references/release-process.md index 8492a6e..615ae33 100644 --- a/skills/github-release/references/release-process.md +++ b/skills/github-release/references/release-process.md @@ -27,7 +27,13 @@ The hooks in this repository block `gh release create` and `gh release delete` t 3. Create release branch: git checkout -b release/vX.Y.Z 4. Bump all version files for the detected ecosystem -5. Update CHANGELOG.md with new section +5. Update CHANGELOG.md: add the new [X.Y.Z] section AND bump the footer + link-references (Keep a Changelog) — repoint the [Unreleased]: line to + compare/vX.Y.Z...HEAD and add a [X.Y.Z]: .../compare/vPREVIOUS...vX.Y.Z line. + The footer LABEL is the plain version ([X.Y.Z]:), while the compare URL uses + the v-prefixed git tags (vPREVIOUS...vX.Y.Z). The footer drifts silently if + only the heading is changed (a prior release's compare link may even be + missing); a reviewer bot will flag the dangling [Unreleased]: ref. 6. Commit: "chore: prepare release vX.Y.Z" 7. Push branch and open PR ```