[Docs] Clarify stable release version lane after prereleases#260
Open
roomote[bot] wants to merge 2 commits into
Open
[Docs] Clarify stable release version lane after prereleases#260roomote[bot] wants to merge 2 commits into
roomote[bot] wants to merge 2 commits into
Conversation
Contributor
Author
|
1 issue outstanding. Action required. See task
|
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
|
|
||
| - Before choosing the target release version, treat the nightly pre-release lane as separate from the stable lane. | ||
| - Zoo Code nightlies publish from the next odd minor version with a large patch number (for example, stable `3.54.x` nightlies become `3.55.x` pre-releases). | ||
| - Stable releases should stay on the even-minor lane. If the latest pre-release line is `3.55.x`, the corresponding stable release should be `3.56.0`, not `3.55.0`. |
Contributor
Author
There was a problem hiding this comment.
This new rule says stable releases must stay on even minors and uses 3.56.0 as the next stable after a 3.55.x prerelease line, but the repo just released v3.55.0 and src/package.json on main is already 3.55.0. With the current nightly workflow, the next prerelease lane from that release becomes 3.57.x, so these instructions would send the next release prep to the wrong version lane.
Contributor
There was a problem hiding this comment.
Yeah we’ll have one cycle where we need to get back on track. I’m ok with prerelease 3.57 staying active for two cycles.
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.
Related GitHub Issue
This docs follow-up does not map to a single approved GitHub issue.
Linked issue: None for this release workflow update.
Description
This updates
.roo/commands/release.mdso the release flow uses generic even/odd placeholder guidance for the nightly pre-release lane versus the stable lane.Reviewers should focus on whether the new guidance matches the current nightly publish workflow and clearly communicates
major.ODD_NUMBER.patchfor pre-releases versusmajor.EVEN_NUMBER.patchfor stable releases without tying the rule to one specific version pair.Test Procedure
.github/workflows/nightly-publish.ymland confirm the documented rule matches the existing prerelease version rewrite logic..roo/commands/release.mdand confirm the release flow now uses generic even/odd placeholder guidance instead of a hard-coded version example.Pre-Submission Checklist
Screenshots / Videos
Not applicable for this docs-only workflow update.
Documentation Updates
.roo/commands/release.mdto document the generic even/odd version-lane rule for prereleases versus stable releases.Additional Notes
This is meant to prevent future release prep from reusing a prerelease version lane for a stable tag while keeping the rule generic.
Get in Touch
Discord username not provided in this task context.