Skip to content

ci(release): start a release's notes at the previous release, not the previous tag - #211

Merged
AlexS-scale merged 3 commits into
mainfrom
AlexS/release-notes-from-previous-release
Oct 15, 2026
Merged

AlexS-scale merged 3 commits into
mainfrom
AlexS/release-notes-from-previous-release

Conversation

@AlexS-scale

@AlexS-scale AlexS-scale commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

What and why

Since #193, a tag whose commit does not pass main's CI is not published, so it gets no GitHub release. The release job starts a release's notes at the previous tag. Thus after a blocked tag, the next release's notes start at the blocked tag, and the pull requests that the blocked tag contains are in no release's notes. This has occurred once: v0.9.1329 did not pass main's CI, and the notes of v0.9.1330 start at v0.9.1329, so #157 is in no release's notes.

The notes now start at the newest earlier tag that has a GitHub release. The tags are still sorted by version, as before, so a re-run of an older tag does not start at a later release. If no earlier tag has a release, the job gives no start tag, as before for the first tag.

How it was tested

The tag selection ran locally with bash -eo pipefail, as in Actions, in a repository with the tags v0.9.8 to v0.9.12 (v0.9.9 and v0.9.10 sort by version, not as text):

Tag Tags with a release Start tag
v0.9.12 v0.9.9, v0.9.10, v0.9.11 v0.9.11
v0.9.12 v0.9.8, v0.9.9, v0.9.10 (v0.9.11 blocked) v0.9.10
v0.9.10 (re-run) v0.9.9, v0.9.12 v0.9.9
v0.9.8 v0.9.9 none
v0.9.12 none none
  • Against this repository's 63 releases, gh api --paginate .../releases gives every release's tag, and the start tags of v0.9.1327 to v0.9.1329 are the tags before them. v0.9.1329 did not pass main's CI and has no release, so the next release starts at v0.9.1328.
  • actionlint: no findings.

RetriggerView in GreptileConfidence Score: 5/5

The PR appears safe to merge.

Summary

Release notes now start at the newest earlier version tag with a GitHub release.

  • Release notes start at the newest earlier tag with a release.

Reviews (3) · Last reviewed commit: "Merge remote-tracking branch 'origin/mai..." · Reviewed by Greptile

… previous tag

A tag that main's CI keeps off PyPI gets no GitHub release. Starting the next release's notes at that tag left its pull requests out of every release's notes.
@AlexS-scale
AlexS-scale requested a review from a team as a code owner October 14, 2026 22:03
Comment thread .github/workflows/publish-pypi.yml Outdated
Comment thread .github/workflows/publish-pypi.yml
- Read every release, not the newest 100, so an old tag's re-run still finds the release before it.
- CONTRIBUTING.md: release notes start at the previous release, and a tag that main's CI kept off PyPI has none.
@AlexS-scale
AlexS-scale merged commit 41e60cc into main Oct 15, 2026
15 checks passed
@AlexS-scale
AlexS-scale deleted the AlexS/release-notes-from-previous-release branch October 15, 2026 20:04
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.

3 participants