Skip to content

ci(release): publish the GitHub release after moving the major tag - #14

Merged
jshvn merged 1 commit into
mainfrom
josh/github-release
Oct 1, 2026
Merged

jshvn merged 1 commit into
mainfrom
josh/github-release

Conversation

@jshvn

@jshvn jshvn commented Oct 1, 2026

Copy link
Copy Markdown
Member

Why

release.yml builds the images and moves v2, but never publishes a GitHub release. The repository page still shows v2.0.1 as Latest, the last release written by hand. Since then v2.1.0 through v2.2.1 have shipped.

What

  • tag job, a new last step: gh release create "$GITHUB_REF_NAME" --verify-tag --generate-notes. The notes list the pull requests merged since the previous release.
  • It runs after v2 moves, so a published release names a version that is live.
  • It is guarded by gh release view, so re-running a failed release leaves an existing release alone.
  • The workflow header comment and the README's Releasing section and diagram say the same.

Test plan

  • Backfill v2.1.0 through v2.2.1 by hand with the same gh release create call. This checks the command and the generated notes, and leaves v2.2.1 as Latest.
  • The next tag publishes its own release.

The release workflow built the images and moved v2 but never published a
GitHub release, so the repository page still showed v2.0.1, the last one
written by hand. The tag job now publishes vX.Y.Z last, with notes
generated from the pull requests merged since the previous release, and
leaves an existing release alone on a re-run.
@jshvn
jshvn merged commit 837aca0 into main Oct 1, 2026
2 checks passed
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