docs(ruby): remove experimental language for precompiled binaries by jdx · Pull Request #8073 · jdx/mise

jdx · 2026-02-09T20:49:27Z

Summary

Remove "experimental" badge from Precompiled Binaries section
Remove requirement for experimental = true setting
Precompiled Ruby binaries are stable and no longer need the experimental flag

Test plan

Verify docs render correctly

🤖 Generated with Claude Code

Note

Low Risk
Documentation-only changes; no runtime or behavior changes, with minimal risk beyond potential user confusion if settings names are incorrect.

Overview
Updates the Ruby docs to treat precompiled binaries as non-experimental by removing the experimental badge/language and the need to enable experimental=true.

Replaces the opt-in instructions with mise settings ruby.compile=false and notes that precompiled binaries are planned to become the default in 2026.8.0.

^{Written by Cursor Bugbot for commit fa51c5d. This will update automatically on new commits. Configure here.}

gemini-code-assist · 2026-02-09T20:49:37Z

Summary of Changes

Hello @jdx, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request updates the Ruby language documentation to reflect the stable status of precompiled Ruby binaries. It removes all mentions of the 'experimental' flag and badge associated with this feature, streamlining the instructions for users and indicating that this method of installation is now fully supported.

Highlights

Documentation Update: The 'experimental' badge has been removed from the 'Precompiled Binaries' section in the Ruby documentation.
Configuration Simplification: The requirement to explicitly enable experimental = true for using precompiled Ruby binaries has been removed from the documentation, simplifying the installation process.
Stability Indication: The documentation now reflects that precompiled Ruby binaries are considered stable and no longer require an experimental flag.

Changelog

docs/lang/ruby.md
- Removed the <Badge type="warning" text="experimental" /> from the 'Precompiled Binaries' heading.
- Updated the introductory text for precompiled binaries to remove the With experimental = true enabled, clause.
- Removed the mise settings experimental=true command from the example usage block.

Activity

The pull request description indicates that it was generated with Claude Code.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

Copilot

Pull request overview

Removes outdated “experimental” wording/requirements from the Ruby docs now that precompiled Ruby binaries are considered stable.

Changes:

Removes the “experimental” badge from the “Precompiled Binaries” section heading
Removes the requirement/instruction to enable experimental = true before using precompiled binaries

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-09T20:49:46Z

docs/lang/ruby.md

+## Precompiled Binaries

-With `experimental = true` enabled, mise can download precompiled Ruby binaries instead of
+Mise can download precompiled Ruby binaries instead of


The docs use inconsistent casing for the tool name ('mise' earlier vs 'Mise' here). For consistency across the doc, use the same casing as the project’s standard (typically 'mise' as used elsewhere in this file).

Suggested change

Mise can download precompiled Ruby binaries instead of

mise can download precompiled Ruby binaries instead of

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

gemini-code-assist

Code Review

This pull request updates the documentation for Ruby to remove the 'experimental' status for precompiled binaries. The changes correctly remove the experimental badge and the requirement to set experimental = true from the Ruby language guide.

However, I've identified a discrepancy where the underlying code in src/plugins/core/ruby.rs and the setting documentation in docs/settings.toml still indicate that this feature is not enabled by default without the experimental flag. This could lead to user confusion. My review includes a detailed comment on this issue.

Aside from this inconsistency, the documentation changes themselves are clear and well-executed.

gemini-code-assist · 2026-02-09T20:53:01Z

docs/lang/ruby.md

+Mise can download precompiled Ruby binaries instead of
 compiling from source. This significantly reduces installation time.


While the documentation is being updated to remove the 'experimental' status for precompiled Ruby binaries, the underlying implementation and other documentation seem to still require the experimental = true setting to use precompiled binaries by default.

Specifically:

The should_try_precompiled function in src/plugins/core/ruby.rs still checks for settings.experimental. Without it, precompiled binaries are only used if ruby.compile is explicitly false.
// src/plugins/core/ruby.rs settings.ruby.compile == Some(false) || (settings.experimental && settings.ruby.compile.is_none())

The documentation for the ruby.compile setting in docs/settings.toml also states that compiling from source is the default unless experimental = true.

This documentation change makes it seem like precompiled binaries are now the default, which could be misleading for users. To make this documentation accurate, the code logic and other related documentation should be updated to not depend on the experimental flag. For example, the logic could be changed to settings.ruby.compile != Some(true) to make precompiled the default.

github-actions · 2026-02-09T21:08:18Z

Hyperfine Performance

`mise x -- echo`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.8 x -- echo`	23.2 ± 0.4	21.8	26.6	1.00
`mise x -- echo`	24.0 ± 0.8	21.4	33.0	1.03 ± 0.04

`mise env`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.8 env`	22.3 ± 1.3	20.8	33.7	1.00 ± 0.08
`mise env`	22.3 ± 1.2	20.8	34.3	1.00

`mise hook-env`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.8 hook-env`	22.3 ± 0.7	21.2	29.9	1.00
`mise hook-env`	22.4 ± 0.8	21.4	25.1	1.00 ± 0.05

`mise ls`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.8 ls`	20.3 ± 0.4	19.6	22.3	1.00
`mise ls`	21.8 ± 1.1	19.9	31.0	1.07 ± 0.06

`xtasks/test/perf`

Command	mise-2026.2.8	mise	Variance
install (cached)	123ms	121ms	+1%
ls (cached)	74ms	74ms	+0%
bin-paths (cached)	77ms	79ms	-2%
task-ls (cached)	532ms	541ms	-1%

@jdx

### 🚀 Features - auto-select no-YJIT Ruby on older glibc systems by @jdx in [#8069](#8069) ### 🐛 Bug Fixes - **(shim)** update mise-shim.exe during self-update on Windows by @jdx in [#8075](#8075) - Bump xx to 2.5 by @erickt in [#8077](#8077) ### 📚 Documentation - **(ruby)** remove experimental language for precompiled binaries by @jdx in [#8073](#8073) ### New Contributors - @erickt made their first contribution in [#8077](#8077) ## 📦 Aqua Registry Updates #### Updated Packages (1) - [`carthage-software/mago`](https://github.com/carthage-software/mago)

…x#8073) ## Summary - Remove "experimental" badge from Precompiled Binaries section - Remove requirement for `experimental = true` setting - Precompiled Ruby binaries are stable and no longer need the experimental flag ## Test plan - [ ] Verify docs render correctly 🤖 Generated with [Claude Code](https://claude.com/claude-code)  --- > [!NOTE] > **Low Risk** > Documentation-only changes; no runtime or behavior changes, with minimal risk beyond potential user confusion if settings names are incorrect. > > **Overview** > Updates the Ruby docs to treat precompiled binaries as non-experimental by removing the *experimental* badge/language and the need to enable `experimental=true`. > > Replaces the opt-in instructions with `mise settings ruby.compile=false` and notes that precompiled binaries are planned to become the default in `2026.8.0`. > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit fa51c5d. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>  Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

@jdx

### 🚀 Features - auto-select no-YJIT Ruby on older glibc systems by @jdx in [jdx#8069](jdx#8069) ### 🐛 Bug Fixes - **(shim)** update mise-shim.exe during self-update on Windows by @jdx in [jdx#8075](jdx#8075) - Bump xx to 2.5 by @erickt in [jdx#8077](jdx#8077) ### 📚 Documentation - **(ruby)** remove experimental language for precompiled binaries by @jdx in [jdx#8073](jdx#8073) ### New Contributors - @erickt made their first contribution in [jdx#8077](jdx#8077) ## 📦 Aqua Registry Updates #### Updated Packages (1) - [`carthage-software/mago`](https://github.com/carthage-software/mago)

Copilot AI review requested due to automatic review settings February 9, 2026 20:49

Copilot AI reviewed Feb 9, 2026

View reviewed changes

docs(ruby): remove experimental language for precompiled binaries

fa51c5d

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

jdx force-pushed the docs/ruby-precompiled branch from a7eb60a to fa51c5d Compare February 9, 2026 20:50

gemini-code-assist bot reviewed Feb 9, 2026

View reviewed changes

jdx enabled auto-merge (squash) February 9, 2026 21:02

jdx merged commit 87c9c97 into main Feb 9, 2026
36 checks passed

jdx deleted the docs/ruby-precompiled branch February 9, 2026 21:04

mise-en-dev mentioned this pull request Feb 9, 2026

chore: release 2026.2.9 #8074

Merged

BrewTestBot mentioned this pull request Feb 10, 2026

mise 2026.2.9 Homebrew/homebrew-core#266756

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs(ruby): remove experimental language for precompiled binaries#8073

docs(ruby): remove experimental language for precompiled binaries#8073
jdx merged 1 commit intomainfrom
docs/ruby-precompiled

jdx commented Feb 9, 2026 •

edited by cursor bot

Loading

Uh oh!

gemini-code-assist bot commented Feb 9, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 9, 2026

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

gemini-code-assist bot Feb 9, 2026

Uh oh!

Uh oh!

github-actions bot commented Feb 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	Mise can download precompiled Ruby binaries instead of
	mise can download precompiled Ruby binaries instead of

		Mise can download precompiled Ruby binaries instead of
		compiling from source. This significantly reduces installation time.

Uh oh!

Conversation

jdx commented Feb 9, 2026 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

gemini-code-assist bot commented Feb 9, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist bot Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions bot commented Feb 9, 2026

Hyperfine Performance

mise x -- echo

mise env

mise hook-env

mise ls

xtasks/test/perf

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jdx commented Feb 9, 2026 •

edited by cursor bot

Loading

`mise x -- echo`

`mise env`

`mise hook-env`

`mise ls`

`xtasks/test/perf`