Skip to content

docs(changelog): backfill 3.1.0, 3.0.0, 2.0.2 entries - #310

Merged
ofloveandhate merged 1 commit into
developfrom
docs/changelog-backfill
Jul 9, 2026
Merged

docs(changelog): backfill 3.1.0, 3.0.0, 2.0.2 entries#310
ofloveandhate merged 1 commit into
developfrom
docs/changelog-backfill

Conversation

@ofloveandhate

Copy link
Copy Markdown
Contributor

The changelog had drifted badly: the last entry was 2.0.1, while 2.0.2, the entire
3.0.0 modernization, and the 3.1.0 line had all shipped — with their notes living only
in commit messages, PRs, and GitHub Releases. This consolidates them back into CHANGELOG.md,
newest-first, in the existing Keep a Changelog format.

New entries

Older 1.0.x / 2.0.1 entries and the commented template are untouched.

Why now (load-bearing)

publish.yml's github-release job builds the release body from the top CHANGELOG.md
block. That block was the stale [2.0.1] — so a final v3.1.0 tag would have published 2.0.1's
notes as the 3.1.0 release. With this merged, the extraction yields exactly the [3.1.0] block
(verified locally against the workflow's extraction logic).

Docs-only (**/*.mdpaths-ignore), so this runs no CI. Merge before tagging v3.1.0.

The changelog had drifted -- the last entry was 2.0.1, while 2.0.2, the entire
3.0.0 modernization, and the 3.1.0 line had all shipped with their notes living
only in commits, PRs, and GitHub Releases. Consolidate them into CHANGELOG.md,
newest-first, in the existing Keep a Changelog format:

- [3.1.0] - 2026-07-09: NumPy interop (#306), UI quality-of-life (#293-#305),
  ZeroDimConfig.recall (#308), prebuilt CI deps (#282), docs-store Pages (#291,#292)
- [3.0.0] - 2026-07-07: reworked from the v3.0.0 release notes (~70 PRs, #238)
- [2.0.2] - 2026-05-22: the missing packaging/CI maintenance entry

This also fixes the release-notes automation: publish.yml's github-release job
extracts the top CHANGELOG block, which was stale [2.0.1]; the final v3.1.0 tag
will now emit the correct [3.1.0] notes.
@ofloveandhate
ofloveandhate merged commit 1e2e9cb into develop Jul 9, 2026
1 check passed
ofloveandhate added a commit that referenced this pull request Jul 9, 2026
Promote the release candidate to the **final 3.1.0**: `VERSION`
`3.1.0rc1` → `3.1.0`.

Once merged, tag `v3.1.0` on the develop tip. That routes through
`publish.yml`'s final-release path
(`is_prerelease=false`): real **PyPI** publish, Sigstore-signed **GitHub
Release** (notes from the
now-current `[3.1.0]` CHANGELOG block, #310), and **versioned docs**
deploy — plus the extra
`check_timing_freshness` gate that only final releases run.

`VERSION` is in the workflows' `paths-ignore`, so this PR runs no CI and
needs no approvals.
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