You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
then you are encouraged to install Ruby using Homebrew.
These two different ways of installing Ruby are extremely different. And they lead to different outcomes. For example, I have been using Ruby on macOS for 5 or 10 years, contribute to major projects and I still cannot reliably make Ruby work on macOS, especially when using Jekyll or Bundler or even rbenv. Please do not respond to this part, please simply let me make the point without further debate that properly installing Ruby can be frustrating for at least one person.
Recommendation
The Ruby project should internally decide one specific preferred installation strategy for macOS. It should then promote that preferred approach prominently (i.e. above other competing instructions) on all its published pages regarding to installing Ruby.
Completing this will allow people to achieve a supported Ruby installation by using the Universal UNIX Software Installation approach:
Delete the software using all the ways that didn't work.
Find the project's website.
Find some instructions on there.
Follow the first applicable instructions you see.
Currently Ruby is not compatible with the Universal instructions because step 3 results in competing instructions.
After this is complete, please consider opinionated and consistent install instructions platforms other than macOS.
The text was updated successfully, but these errors were encountered:
What if we updated the instructions on https://www.ruby-lang.org/en/documentation/installation/#homebrew to include the rbenv/rvm as well as direct installation of ruby using homebrew. I would prefer rbenv or rvm because if you work on different projects you can use a version of ruby per project while not touching the preinstalled one on mac. I don't think directly installing ruby makes sense unless you use just one version for all the projects (which is unlikely).
If you do this:
then you are encouraged to use rbenv or RVM to install Ruby.
But if you:
then you are encouraged to install Ruby using Homebrew.
These two different ways of installing Ruby are extremely different. And they lead to different outcomes. For example, I have been using Ruby on macOS for 5 or 10 years, contribute to major projects and I still cannot reliably make Ruby work on macOS, especially when using Jekyll or Bundler or even rbenv. Please do not respond to this part, please simply let me make the point without further debate that properly installing Ruby can be frustrating for at least one person.
Recommendation
The Ruby project should internally decide one specific preferred installation strategy for macOS. It should then promote that preferred approach prominently (i.e. above other competing instructions) on all its published pages regarding to installing Ruby.
Completing this will allow people to achieve a supported Ruby installation by using the Universal UNIX Software Installation approach:
Currently Ruby is not compatible with the Universal instructions because step 3 results in competing instructions.
After this is complete, please consider opinionated and consistent install instructions platforms other than macOS.
The text was updated successfully, but these errors were encountered: