Skip to content

ci: prune old release pages after a release - #3

Merged
mikield merged 1 commit into
mainfrom
ci/prune-old-releases
Sep 2, 2026
Merged

mikield merged 1 commit into
mainfrom
ci/prune-old-releases

Conversation

@mikield

@mikield mikield commented Sep 2, 2026

Copy link
Copy Markdown
Member

The releases page is for finding the current version; CHANGELOG.md is the ledger, and semantic-release writes the same notes into both. Keeping every release forever only makes the page harder to read.

Kept: every major, the last two feature releases, the last three fixes — plus whatever GitHub is currently showing as latest, whichever bucket that fell into.

Tags are never touched

This is the whole risk of the change, so it is worth being explicit. Packagist resolves a version from the git tag, not from the GitHub release, and a composer.lock naming a version has to stay installable years from now. gh release delete leaves the tag alone unless asked for --cleanup-tag, which this deliberately never passes.

So the only thing removed is the rendered page. Nothing about installing an old version changes, and no notes are lost.

🤖 Generated with Claude Code

The releases page is for finding the current version; CHANGELOG.md is the
ledger, and semantic-release writes the same notes into both. Keeping
every release forever only makes the page harder to read.

Every major stays, along with the last two feature releases and the last
three fixes. Tags are never touched — Packagist resolves a version from
the tag, and a lock file naming one has to stay installable years later,
so `gh release delete` is deliberately called without --cleanup-tag.
@mikield
mikield merged commit 76865e0 into main Sep 2, 2026
3 of 4 checks passed
@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

🎉 This PR is included in version 1.0.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant