docs(ruby): document precompiled build revisions#10419
Conversation
|
Note Reviews pausedIt 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 Use the following commands to manage reviews:
Use the checkboxes below for quick actions:
📝 WalkthroughWalkthroughTwo documentation sections are added: one to ChangesRuby precompiled build revision documentation
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~3 minutes Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. Comment |
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
❌ 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.
Greptile SummaryDocumentation-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.
Confidence Score: 5/5Documentation-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
Reviews (6): Last reviewed commit: "docs(lock): link ruby build revision det..." | Re-trigger Greptile |
Hyperfine Performance
|
| 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% |

Summary
jdx/rubyworkmise.lockkeeps the Ruby version while the platform URL identifies the build revisionWhy
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 inmise.lockand how to update a lockfile that still points at an older/base revision.Validation
This PR was generated by an AI coding assistant.
Summary by CodeRabbit
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/rubywork when using mise andmise.lock.docs/lang/ruby.mdadds a Precompiled build revisions section: revision tags like3.3.11-1vs the logical Ruby version, typical reasons for rebuilds, unlocked vs locked install behavior, how to read the revision from the platformurl, and how to refresh to the latest revision (mise lock ruby,mise install --force ruby).docs/dev-tools/mise-lock.mdadds a troubleshooting subsection that shows the same URL pattern (versionstays3.3.11while the tag inurlpins 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.