Skip to content

docs: drop CHANGELOG; GitHub release notes are the release record - #65

Merged
Kiran01bm merged 3 commits into
mainfrom
kiran01bm/release-v0.1.1
Aug 30, 2026
Merged

docs: drop CHANGELOG; GitHub release notes are the release record#65
Kiran01bm merged 3 commits into
mainfrom
kiran01bm/release-v0.1.1

Conversation

@Kiran01bm

@Kiran01bm Kiran01bm commented Aug 30, 2026

Copy link
Copy Markdown
Collaborator

Drop the in-repo CHANGELOG; GitHub release notes become the single release record.

Why

Maintaining both a Keep-a-Changelog file and GitHub release notes means two records of the same facts that must be kept in sync — and the file already drifted once (the Unreleased section was never rolled at v0.1.0, mixing shipped and unshipped entries). spirit and schemabot both publish release notes exclusively on GitHub releases; pg-sprite follows the same pattern.

What

  • Delete CHANGELOG.md. Nothing else referenced it (no CI check, no doc links).
  • Caller-observable changes (exit codes, verdict fields, reason vocabulary) land in each release's notes as highlights plus upgrade notes. The deleted file's content remains in git history.

Before / after

Before                                 After
┌───────────────────────────┐         ┌───────────────────────────┐
│ CHANGELOG.md (in repo)    │         │ GitHub release notes      │
│  + GitHub release notes   │         │  (single record:          │
│  (two records, drifted    │         │   highlights +            │
│   at v0.1.0)              │         │   upgrade notes)          │
└───────────────────────────┘         └───────────────────────────┘

The Unreleased section was never rolled at the v0.1.0 tag, so it mixed
shipped-in-0.1.0 entries with post-tag work. Split it: 0.1.1 carries only
what landed after the tag (greenfield create, RunDesired, search_path
pinning, DROP NOT NULL destructive); everything older moves under 0.1.0.
New capabilities (greenfield create, RunDesired) and caller-observable
behavior changes warrant a minor bump, matching spirit's release
numbering.
@Kiran01bm Kiran01bm changed the title docs: roll CHANGELOG for v0.1.1, backfill the v0.1.0 section docs: roll CHANGELOG for v0.2.0, backfill the v0.1.0 section Aug 30, 2026
One record per release instead of two to keep in sync, matching how
spirit and schemabot publish releases. Caller-observable changes land
in each release's notes (highlights + upgrade notes).
@Kiran01bm Kiran01bm changed the title docs: roll CHANGELOG for v0.2.0, backfill the v0.1.0 section docs: drop CHANGELOG; GitHub release notes are the release record Aug 30, 2026
@Kiran01bm
Kiran01bm marked this pull request as ready for review August 30, 2026 06:08
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Kiran01bm
Kiran01bm merged commit 127f158 into main Aug 30, 2026
8 checks passed
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