Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jdx merged 1 commit into from
Feb 9, 2026
Merged

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

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions docs/lang/ruby.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,15 @@ from source. Ensure that you have the necessary
You can check its [README](https://github.com/rbenv/ruby-build/blob/master/README.md) for additional settings and some
troubleshooting.

## Precompiled Binaries <Badge type="warning" text="experimental" />
## Precompiled Binaries

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

Copilot AI Feb 9, 2026

Copy link

Choose a reason for hiding this comment

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

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

Copilot uses AI. Check for mistakes.
compiling from source. This significantly reduces installation time.
Comment on lines +29 to 30

@gemini-code-assist gemini-code-assist Bot Feb 9, 2026

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.

high

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:

  1. 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())
  2. 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.


Precompiled binaries will become the default in 2026.8.0. To opt in now:

```sh
mise settings experimental=true
mise settings ruby.compile=false
mise use ruby@3.4.1
```

Expand Down
Loading