docs: use exact version tags instead of the moving v1 tag - #116
Merged
fengmk2 merged 4 commits intoAug 4, 2026
Merged
Conversation
Copy link
Copy Markdown
Member
Sorry, something went wrong.
The v1 major tag is frozen at v1.15.0: the voidzero-dev org-level tag ruleset blocks non-fast-forward tag updates, so it can no longer be moved on each release. - Add a Versioning section telling users to pin an exact release tag (or commit SHA) and warning that v1 is frozen and should not be used - Pin all GitHub, GitLab, and Azure examples to v1.16.0 - Pin setup-ref in the GitLab examples to match the remote URL and drop the now-redundant pinned-runtime section - Rewrite the release steps: bump the README tags, no v1 move
The release PR now bumps both the package.json version and the README version tags before the tag is cut.
Copy link
Copy Markdown
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the repository documentation to discourage using the frozen v1 moving tag and instead pin consumers to exact immutable release tags (or SHAs), aligning GitHub Actions / GitLab / Azure usage examples with the current release practices.
Changes:
- Added a new Versioning section explaining exact tag/SHA pinning and warning that v1 is frozen at v1.15.0.
- Updated GitHub/GitLab/Azure examples to pin v1.16.0 and aligned GitLab setup-ref / Azure setupRef guidance with the chosen tag.
- Bumped package.json version to 1.16.0 and updated the release process docs to reflect “bump versions via PR before tagging”.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| README.md | Adds versioning guidance and updates all usage + release documentation to use exact tags rather than v1. |
| package.json | Updates the project version to track the latest release (1.16.0). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Sorry, something went wrong.
Comment thread
README.md
Outdated
This comment was marked as resolved.
This comment was marked as resolved.
Copy link
Copy Markdown
Contributor
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.
Suppressed comments (1)README.md:637
- The release checklist says to confirm only dist/index.mjs is in sync, but just above it the README states that multiple generated entrypoints under dist/ must be committed (dist/index.mjs, dist/gitlab/index.mjs, dist/azure/index.mjs). This mismatch could lead to cutting a release with stale GitLab/Azure runtimes.
2. Update `main` and confirm `dist/index.mjs` is in sync (the working tree must stay clean after building):
Sorry, something went wrong.
Copy link
Copy Markdown
Contributor
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.
Suppressed comments (1)README.md:637
- The release checklist says to confirm only dist/index.mjs is in sync, but the build also produces the GitLab and Azure runtimes under dist/ (see the “Before Committing” section just above). Calling out only dist/index.mjs is misleading for release verification; consider referring to dist/ outputs (or listing the three entry points) instead.
2. Update `main` and confirm `dist/index.mjs` is in sync (the working tree must stay clean after building):
Sorry, something went wrong.
fengmk2
added a commit
that referenced
this pull request
Aug 4, 2026
Follow-up to #116 (now merged). An unpinned `setup-ref` (GitLab) or `setupRef` (Azure) downloaded the compiled runtime from the moving `v1` tag, which is now frozen at v1.15.0, so unpinned includes silently ran a stale v1.15.0 runtime. - Default `setup-ref` / `setupRef` (input default and bash env fallback) to `v1.16.0`, the latest release - Update the README input tables and the release checklist: the release PR now also bumps these defaults, so from v1.17.0 on the shipped template downloads the runtime of its own release - Update the `src/azure/template.test.ts` assertion The README examples keep the explicit `setup-ref` pin, which is still the recommended setup and the only correct one for v1.16.0 itself (its shipped template default is the frozen `v1`).
Merged
fengmk2
added a commit
that referenced
this pull request
Aug 4, 2026
Bump the version to v1.16.1 in package.json, the README examples, and the setup-ref / setupRef defaults in the GitLab and Azure templates. Changes since v1.16.0: - fix: stop defaulting setup-ref/setupRef to the frozen v1 tag (#117) - docs: use exact version tags instead of the moving v1 tag (#116) After merge, tag the merge commit as v1.16.1 and push the tag. --------- Signed-off-by: MK (fengmk2) <fengmk2@gmail.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
fengmk2
added a commit
to voidzero-dev/vite-plus
that referenced
this pull request
Aug 7, 2026
The `v1` tag for `setup-vp` no longer receives updates. Users must select an exact release tag or commit SHA. The examples use a version placeholder, with update instructions for Dependabot and Renovate. Related: voidzero-dev/setup-vp#116
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.
The v1 major tag is frozen at v1.15.0: the voidzero-dev org-level tag ruleset blocks non-fast-forward tag updates, so it can no longer be moved on each release. This PR restructures the docs around exact version pinning.
Follow-up in #117 (stacked on this PR): the GitLab setup-ref and Azure setupRef template defaults still fall back to the frozen v1, so an unpinned include silently gets the v1.15.0 runtime.