Skip to content

move Unreleased above v0.111.0 in CHANGELOG - #86

Merged
bborbe merged 1 commit into
masterfrom
fix/changelog-unreleased-ordering
Aug 16, 2026
Merged

move Unreleased above v0.111.0 in CHANGELOG#86
bborbe merged 1 commit into
masterfrom
fix/changelog-unreleased-ordering

Conversation

@bborbe

@bborbe bborbe commented Aug 16, 2026

Copy link
Copy Markdown
Owner

Problem

#85 anchored its ## Unreleased section above ## v0.110.0. v0.111.0 was released from a commit in between, and landed above it. Both merges were clean — nothing conflicted — leaving ## Unreleased stranded between two released sections:

## v0.111.0
## Unreleased    ← here
## v0.110.0

The releaser reads the newest section. With ## Unreleased sitting below a released one, it either renames a section in the wrong position or concludes there is nothing to ship. A release-check trigger fired after #85 merged produced no new tag, which is consistent with the latter — so #85's fix is on master but cannot currently be released.

Why the usual guard missed it

The changelog-fold check (git diff origin/master -- CHANGELOG.md | grep -E '^[-+]## ') passes at push time, because on the branch ## Unreleased genuinely is the top section. It only becomes wrong when someone else's release lands above it — after the check has already run and passed.

Worth knowing: anchoring a new ## Unreleased relative to a specific released version is what creates the exposure. Anchoring it to the top of the section list would not have.

Change

Pure reordering — ## Unreleased moved above ## v0.111.0. Bullet text unchanged (git diff touches 4 lines, 2 of them the same bullet moving).

Verification

grep -n '^## ' CHANGELOG.md | head -4
# 11: ## Unreleased
# 15: ## v0.111.0
# 19: ## v0.110.0
# 23: ## v0.109.3

After merge, a release check should cut the version carrying #85's Phase 5.5 fix.

PR #85 anchored its '## Unreleased' section above '## v0.110.0'. v0.111.0 was
released from a commit in between and landed above it, so the merge — clean, no
conflict — left Unreleased stranded between two released sections:

  ## v0.111.0
  ## Unreleased   <- here
  ## v0.110.0

The releaser reads the newest section; with Unreleased below a released one it
either renames a section in the wrong position or sees nothing to ship. A
release-check trigger after #85 merged produced no new tag, which is consistent
with the latter.

Pure reordering — the bullet text is unchanged.

@ben-s-pull-request-reviewer ben-s-pull-request-reviewer Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The diff is a pure CHANGELOG.md reordering — ## Unreleased moved above ## v0.111.0. Per the changelog guide, ## Unreleased must go directly above the highest ## vX.Y.Z (newest version first). The post-change CHANGELOG is correctly ordered.

No code files changed. Step 4 is not applicable (no rule-relevant source files). The change is clean.

{
  "verdict": "approve",
  "summary": "CHANGELOG-only reorder placing `## Unreleased` above `## v0.111.0` — correct per changelog convention. No code changes.",
  "comments": [],
  "concerns_addressed": []
}

@bborbe
bborbe merged commit 8c2357d into master Aug 16, 2026
1 check passed
@bborbe
bborbe deleted the fix/changelog-unreleased-ordering branch August 16, 2026 13:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant