Conversation
Following the general convention for GitHub actions, whenever we tag
(for example) v1.0.9, we also update the v1 tag to match. This allows
users of the action to write:
uses: endlessm/amalgamate-pages@v1
and automatically receive minor updates to the action.
So far I have been doing this by hand:
# Tag the new version as normal
git tag -s -m 'Version 1.0.9' v1.0.9
# Now force-update the v1 tag to match
git tag --force -s v1 -m "Update v1 tag" v1.0.9^{}
# And push both
git push origin v1.0.9 +v1
The v1.0.9^{} syntax means that the v1 tag points to the commit that
v1.0.9 points at, rather than to the v1.0.9 tag (which in turn points to
that commit). Nested tags cause git to warn you as follows when you
create them:
hint: You have created a nested tag. The object referred to by your new tag is
hint: already a tag. If you meant to tag the object that it points to, use:
hint:
hint: git tag -f test v1.0.9^{}
hint: Disable this message with "git config advice.nestedTag false"
This process is not obvious and is error-prone. It would be more
convenient to be able to make the precise version tag as normal (either
from the git command line, or from the GitHub Releases web interface)
and have the major version tag be updated automatically.
Add a workflow that performs this process.
Fixes #44
Member
Author
|
Annoyingly this can't really be tested without performing a minor release. My suggestion is that, if there are no glaringly obvious problems, we merge this, make a minor release (to pick up #43), and see if it works :) |
manuq
approved these changes
Jul 8, 2025
Contributor
manuq
left a comment
There was a problem hiding this comment.
This sounds like it could work. So yeah no problem performing a minor release to give it a try.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Following the general convention for GitHub actions, whenever we tag (for example) v1.0.9, we also update the v1 tag to match. This allows users of the action to write:
and automatically receive minor updates to the action.
So far I have been doing this by hand:
The v1.0.9^{} syntax means that the v1 tag points to the commit that v1.0.9 points at, rather than to the v1.0.9 tag (which in turn points to that commit). Nested tags cause git to warn you as follows when you create them:
This process is not obvious and is error-prone. It would be more convenient to be able to make the precise version tag as normal (either from the git command line, or from the GitHub Releases web interface) and have the major version tag be updated automatically.
Add a workflow that performs this process.
Fixes #44