Skip to content

[Docs] Clarify stable release version lane after prereleases#260

Open
roomote[bot] wants to merge 2 commits into
mainfrom
docs-release-version-lane-guidance
Open

[Docs] Clarify stable release version lane after prereleases#260
roomote[bot] wants to merge 2 commits into
mainfrom
docs-release-version-lane-guidance

Conversation

@roomote
Copy link
Copy Markdown
Contributor

@roomote roomote Bot commented May 22, 2026

Opened on behalf of Elliott de Launay. View the task or mention @roomote for follow-up asks.

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.md so 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.patch for pre-releases versus major.EVEN_NUMBER.patch for stable releases without tying the rule to one specific version pair.

Test Procedure

  • Review .github/workflows/nightly-publish.yml and confirm the documented rule matches the existing prerelease version rewrite logic.
  • Review .roo/commands/release.md and confirm the release flow now uses generic even/odd placeholder guidance instead of a hard-coded version example.
  • No runtime or UI validation was needed for this docs-only workflow update.

Pre-Submission Checklist

  • Issue Linked: This PR is linked to an approved GitHub Issue (see "Related GitHub Issue" above).
  • Scope: My changes are focused on the linked issue (one major feature/fix per PR).
  • Self-Review: I have performed a thorough self-review of my code.
  • Testing: New and/or updated tests have been added to cover my changes (if applicable).
  • Documentation Impact: I have considered if my changes require documentation updates (see "Documentation Updates" section below).
  • Contribution Guidelines: I have read and agree to the Contributor Guidelines.

Screenshots / Videos

Not applicable for this docs-only workflow update.

Documentation Updates

  • No documentation updates are required.
  • Yes, documentation updates are required. Updated .roo/commands/release.md to 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.

@roomote roomote Bot added the roomote:auto-resolve-conflicts Allow Roomote to auto-resolve merge conflicts for this PR label May 22, 2026
@roomote
Copy link
Copy Markdown
Contributor Author

roomote Bot commented May 22, 2026

1 issue outstanding. Action required. See task

  • The new even-minor stable-release rule conflicts with the current v3.55.0 release state and points the next release prep at the wrong version lane.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 22, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Comment thread .roo/commands/release.md Outdated

- 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`.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@edelauna edelauna marked this pull request as ready for review May 23, 2026 03:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

roomote:auto-resolve-conflicts Allow Roomote to auto-resolve merge conflicts for this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants