Thanks to visit codestin.com
Credit goes to github.com

Skip to content

docs(ruby): document precompiled build revisions#10419

Merged
jdx merged 9 commits into
mainfrom
codex/mise-build-revision-releases
Jun 14, 2026
Merged

docs(ruby): document precompiled build revisions#10419
jdx merged 9 commits into
mainfrom
codex/mise-build-revision-releases

Conversation

@jdx

@jdx jdx commented Jun 13, 2026

Copy link
Copy Markdown
Owner

Summary

  • document how precompiled Ruby build revision releases from jdx/ruby work
  • explain how mise.lock keeps the Ruby version while the platform URL identifies the build revision
  • show how users can inspect their current revision and refresh to the latest build revision

Why

Precompiled Ruby binaries can be rebuilt for the same Ruby version under release tags like 3.3.11-1. Users need to know how that appears in mise.lock and how to update a lockfile that still points at an older/base revision.

Validation

  • cargo test github::tests::test_build_revision --all-features
  • git diff --check

This PR was generated by an AI coding assistant.

Summary by CodeRabbit

  • Documentation
    • Added new guidance on Ruby “precompiled build revisions,” including how revision tags (e.g., 3.3.11-1) relate to the base Ruby version in lockfiles, how to read the selected revision from the download URL, and commands to update an existing lock/install to the latest available build revision.

Note

Low Risk
Documentation-only changes with no runtime or configuration behavior changes.

Overview
Documents how precompiled Ruby build revisions from jdx/ruby work when using mise and mise.lock.

docs/lang/ruby.md adds a Precompiled build revisions section: revision tags like 3.3.11-1 vs the logical Ruby version, typical reasons for rebuilds, unlocked vs locked install behavior, how to read the revision from the platform url, and how to refresh to the latest revision (mise lock ruby, mise install --force ruby).

docs/dev-tools/mise-lock.md adds a troubleshooting subsection that shows the same URL pattern (version stays 3.3.11 while the tag in url pins the build) and links to the Ruby doc for full detail.

Reviewed by Cursor Bugbot for commit be33226. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitai Bot commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Two documentation sections are added: one to docs/dev-tools/mise-lock.md and one to docs/lang/ruby.md. Both explain that precompiled Ruby binaries may be republished under build revision tags (e.g., 3.3.11-1), how the revision is recorded in mise.lock platform URLs, and the commands to update a lockfile and reinstall to the latest build revision.

Changes

Ruby precompiled build revision documentation

Layer / File(s) Summary
Build-revision docs in lock and Ruby guides
docs/lang/ruby.md, docs/dev-tools/mise-lock.md
Adds "Precompiled build revisions" sections to both the Ruby backend guide and the lock file guide, describing revision tags, how mise.lock encodes the selected revision in the platform URL, how to read the revision number, and mise lock ruby / mise install --force ruby commands to update to the latest build revision.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 A rabbit once locked a fine gem,
With revisions tucked neatly in stem.
"The version stays same,
But the URL's the game!"
Hop mise lock ruby — sorted, ahem! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'docs(ruby): document precompiled build revisions' directly summarizes the main change - adding documentation about precompiled Ruby build revisions across two documentation files.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Comment @coderabbitai help to get the list of available commands and usage tips.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit f4875ee. Configure here.

Comment thread src/backend/github.rs Outdated
@greptile-apps

greptile-apps Bot commented Jun 14, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Documentation-only PR that adds user-facing guidance for precompiled Ruby build revisions — rebuilds of portable binaries that share a Ruby version number but carry a distinct release tag (e.g. 3.3.11-1).

  • docs/lang/ruby.md: adds a new "Precompiled build revisions" subsection covering what triggers a rebuild, how mise.lock pins the revision via the platform url, how to read the current revision from the URL path, and the mise lock ruby + mise install --force ruby workflow to upgrade to the latest revision.
  • docs/dev-tools/mise-lock.md: adds a matching troubleshooting entry with a minimal TOML example and a cross-link back to the detailed Ruby page.

Confidence Score: 5/5

Documentation-only change with no runtime or configuration impact; safe to merge.

Both changed files are Markdown documentation. The TOML snippets match the lockfile format used throughout the docs, the commands are valid patterns already present elsewhere, and the anchor cross-link resolves correctly. No executable code was modified.

No files require special attention.

Important Files Changed

Filename Overview
docs/lang/ruby.md Adds a "Precompiled build revisions" subsection explaining revision tags, lockfile pinning, and the update workflow — content is accurate, TOML format matches existing examples, and commands are valid.
docs/dev-tools/mise-lock.md Adds a short Ruby-specific troubleshooting section with a cross-link to the Ruby precompiled build revisions page; anchor URL and TOML snippet are consistent with the rest of the file.

Reviews (6): Last reviewed commit: "docs(lock): link ruby build revision det..." | Re-trigger Greptile

Comment thread src/github.rs Outdated
@github-actions

github-actions Bot commented Jun 14, 2026

Copy link
Copy Markdown

Hyperfine Performance

mise x -- echo

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.6.6 x -- echo 19.4 ± 0.9 17.6 23.3 1.00
mise x -- echo 20.2 ± 1.5 18.2 44.0 1.04 ± 0.09

mise env

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.6.6 env 19.0 ± 0.8 17.4 22.9 1.00
mise env 19.6 ± 0.9 17.8 23.7 1.03 ± 0.07

mise hook-env

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.6.6 hook-env 19.6 ± 0.8 17.8 23.9 1.00
mise hook-env 20.2 ± 0.9 18.5 24.3 1.03 ± 0.06

mise ls

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.6.6 ls 16.1 ± 0.8 14.6 22.5 1.00
mise ls 16.9 ± 0.9 15.1 20.5 1.05 ± 0.07

xtasks/test/perf

Command mise-2026.6.6 mise Variance
install (cached) 134ms 134ms +0%
ls (cached) 58ms 59ms -1%
bin-paths (cached) 66ms 65ms +1%
task-ls (cached) 125ms 127ms -1%

@jdx jdx changed the title fix(github): use build revision releases for mise docs(ruby): document precompiled build revisions Jun 14, 2026
@jdx jdx enabled auto-merge (squash) June 14, 2026 02:16
@jdx jdx merged commit 9be4746 into main Jun 14, 2026
35 checks passed
@jdx jdx deleted the codex/mise-build-revision-releases branch June 14, 2026 02:28
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