Skip to content

docs: backfill 4.2.9, 5.0.0 and 5.0.1 into the changelog - #213

Merged
derrickmehaffy merged 1 commit into
mainfrom
fix/changelog-backfill
Aug 14, 2026
Merged

derrickmehaffy merged 1 commit into
mainfrom
fix/changelog-backfill

Conversation

@derrickmehaffy

Copy link
Copy Markdown
Contributor

Good catch. The root CHANGELOG.md jumped straight from 5.1.0-beta to 4.2.8:

## [5.1.0-beta] (2026-08-14)
## [4.2.8]      (2023-07-27)   ← three shipped releases missing

4.2.9, 5.0.0 and 5.0.1 were all absent.

Why

Nothing was lost — it was recorded elsewhere. The root file is inherited from
the strapi-plugin-rest-cache repo and stopped being maintained at 4.2.8; the
5.x entries were kept in packages/plugin-rest-cache/CHANGELOG.md instead.

Releases are now cut from the root, so the root file is the changelog — and
the gap only became visible once 5.1.0-beta landed on top of it.

Reconstructed from what actually shipped

Release Source
5.0.1 (2025-09-25) packages/plugin-rest-cache/CHANGELOG.md; npm publish date
5.0.0 (2025-09-17) the v5.0.0 GitHub release — Strapi 5 migration and its breaking changes
4.2.9 (2024-03-24) the commits between v4.2.8 and v4.2.9

The 5.0.0 breaking changes are worth having written down rather than only in a
release body: Couchbase provider removed, all three packages renamed under
@strapi-community/, and no Strapi 4 support.

Two dead links fixed

  • The 5.1.0-beta heading compared monorepo-v5.0.1...monorepo-v5.1.0-beta.
    Neither tag exists — that naming came from the component bug fixed in
    fix(release): tag releases v<version>, not monorepo-v<version> #212. Now compares against v5.0.0.
  • 5.0.1 is no longer a compare link. It was published to npm without a tag or
    a release, so there was nothing on the other end of it.

Result is continuous: 5.1.0-beta → 5.0.1 → 5.0.0 → 4.2.9 → 4.2.8 → …

Note

The per-package CHANGELOG.md files are now orphaned — release-please only
maintains the root one under the single-release config. Worth deciding
separately whether to delete them or leave them as a historical record; they
are not wrong, just frozen.

🤖 Generated with Claude Code

The root CHANGELOG.md jumped straight from 5.1.0-beta to 4.2.8. Three releases
that actually shipped were missing from it: 4.2.9, 5.0.0 and 5.0.1.

They were never lost, just recorded elsewhere. The root file is inherited from
the strapi-plugin-rest-cache repository and stopped being maintained at 4.2.8,
and the 5.x entries were kept in packages/plugin-rest-cache/CHANGELOG.md
instead. Releases are now cut from the root, so the root file is the changelog
and the gap became visible the moment 5.1.0-beta landed on top of it.

Reconstructed from what shipped: the v5.0.0 GitHub release for the Strapi 5
migration and its breaking changes, the package changelog for 5.0.1, and the
commits between v4.2.8 and v4.2.9.

Two links are corrected too. The 5.1.0-beta heading compared
monorepo-v5.0.1...monorepo-v5.1.0-beta, and neither tag exists - that naming
came from the component bug fixed in #212. It now compares against v5.0.0. And
5.0.1 is no longer a compare link at all: it was published to npm without a tag
or release, so there is nothing to compare against.

Co-Authored-By: Claude <noreply@anthropic.com>
@derrickmehaffy
derrickmehaffy merged commit 65d4f1e into main Aug 14, 2026
12 checks passed
This was referenced Aug 14, 2026
@derrickmehaffy
derrickmehaffy deleted the fix/changelog-backfill branch August 14, 2026 05:45
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