Skip to content

A change log and release notes generated from pull request descriptions - #339

Merged
mattshax merged 1 commit into
mainfrom
change-records
Sep 12, 2026
Merged

mattshax merged 1 commit into
mainfrom
change-records

Conversation

@mattshax

Copy link
Copy Markdown
Member

Versions were tagged but never published as GitHub Releases, so the change record existed only as PR titles. Every merged PR here carries a description written as a change note, so the notes for a version are those descriptions in order, and the change log is the same for every version at once.

scripts/release-notes.mjs produces both from the tags and the gh CLI (vX.Y for one version, --changelog for all), mapping squash commits to PRs by the (#N) suffix and dropping attribution trailers. CHANGELOG.md is its output for all sixty versions to date. The README documents the release steps, and every existing tag is being published as a Release with these notes.

Also makes the run-watch test deterministic: it slept a fixed span and asserted a count band, which flaked on the macOS runner; it now waits for the give-up point and then proves no further polls happen.

…riptions

Versions were tagged but never published as releases, so the change
record existed only as pull request titles. Every merged pull request
here carries a description written as a change note, so the notes for a
version are those descriptions in order, and the change log is the same
for every version at once. scripts/release-notes.mjs produces both from
the tags and the gh CLI, dropping attribution trailers, and CHANGELOG.md
is its output for all sixty versions to date. The README documents the
release steps.

Also makes the run-watch test deterministic. It slept a fixed span and
asserted a count band, which is exactly the assertion that flakes on a
loaded runner; it now waits for the give-up point and then proves no
further polls happen.
@mattshax
mattshax merged commit 7fc1cfd into main Sep 12, 2026
2 checks passed
@mattshax
mattshax deleted the change-records branch September 12, 2026 18:21
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