Skip to content

Push the tag with a command that actually pushes it - #9

Merged
devpeer-tom merged 1 commit into
mainfrom
docs/tag-push-and-example-version
Aug 12, 2026
Merged

devpeer-tom merged 1 commit into
mainfrom
docs/tag-push-and-example-version

Conversation

@devpeer-tom

Copy link
Copy Markdown
Contributor

Three corrections found while cutting v1.0.1.

The documented release recipe does not push the tag. git push --follow-tags pushes
annotated tags only; git tag v1.0.1 creates a lightweight one. The push reports success,
the tag stays local, and nothing triggers — which is what happened cutting 1.0.1, and had
to be fixed by hand. git push origin main v1.1.0 works for either kind.
scripts/bump-version.mjs prints the same recipe, so it changes too.

The README verification examples named v1.0.0, which was uploaded to the store by hand
and has no GitHub Release. gh release download v1.0.0 fails. They now name v1.0.1.

The 1.0.1 changelog entry claimed the build reproduces 1.0.0's content digest. It
cannot — public/manifest.json carries the version and is one of the hashed files. The
entry now says what is actually true: the version string is the only difference under
src/ or public/, and the digest necessarily differs because of it. The published
release notes have been corrected to match.

`git push --follow-tags` pushes annotated tags only, and `git tag v1.0.1` makes a
lightweight one — so the documented release recipe pushes the commit, reports success,
and silently leaves the trigger behind. It did exactly that cutting 1.0.1.

Naming the tag explicitly works for either kind. bump-version.mjs prints the same
command, so it changes too.

Also point the README's verification examples at v1.0.1. They named v1.0.0, which was
uploaded to the store by hand and has no GitHub Release — `gh release download v1.0.0`
would have failed for anyone who tried it.

And correct the 1.0.1 changelog entry: it claimed the build reproduces 1.0.0's content
digest. It cannot. The manifest version is one of the hashed files.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@devpeer-tom
devpeer-tom merged commit 32aeed8 into main Aug 12, 2026
2 checks passed
@devpeer-tom
devpeer-tom deleted the docs/tag-push-and-example-version branch August 12, 2026 15:36
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