Skip to content

docs: link CHANGELOG.md from README - #15

Merged
dconlan merged 1 commit into
mainfrom
docs/link-changelog-from-readme
Sep 3, 2026
Merged

docs: link CHANGELOG.md from README#15
dconlan merged 1 commit into
mainfrom
docs/link-changelog-from-readme

Conversation

@dconlan

@dconlan dconlan commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

CHANGELOG.md doesn't exist yet — release-please creates it as part of its first merged release PR — but the link is stable and will resolve once that lands.

Keeping the rich per-version README sections as the primary changelog (they explain why, not just what); CHANGELOG.md is the terser, automatically generated commit-by-commit record underneath, not a replacement for them.

Co-Authored-By: Claude Sonnet 5 noreply@anthropic.com

CHANGELOG.md doesn't exist yet - release-please creates it as part of
its first merged release PR - but the link is stable and will resolve
once that lands. Keeping the rich per-version README sections as the
primary changelog (they explain why, not just what); CHANGELOG.md is
the terser, automatically generated commit-by-commit record
underneath, not a replacement for them.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@dconlan
dconlan merged commit 1bbbb1d into main Sep 3, 2026
4 checks passed
@dconlan
dconlan deleted the docs/link-changelog-from-readme branch September 3, 2026 01:18
dconlan added a commit that referenced this pull request Sep 3, 2026
Makes the CHANGELOG.md link added to README.md (#15) resolve to a real
file instead of a 404, ahead of the first real release-please run
creating it for real.

Verified this is safe by reading release-please's actual updater source
(`updaters/changelog.js` in the npm package): content is coerced with
`content || ''`, and an empty string is falsy, so a 0-byte file takes
the exact same code path as a genuinely absent file — clean header +
first entry, nothing demoted or duplicated. Any non-empty placeholder
text, by contrast, survives the bootstrap but gets pushed below the
first release entry as an orphaned, permanently-demoted sub-heading —
confirmed from the same source, not worth risking.

No conflict with #15 (different file) — can merge in either order.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
@dconlan dconlan mentioned this pull request Sep 3, 2026
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