Skip to content
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.

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

Make installation instructions consistent #2874

Open
fulldecent opened this issue Sep 6, 2022 · 1 comment
Open

Make installation instructions consistent #2874

fulldecent opened this issue Sep 6, 2022 · 1 comment

Comments

@fulldecent
Copy link

fulldecent commented Sep 6, 2022

If you do this:

  1. Visit https://www.ruby-lang.org/
  2. Click the large DOWNLOAD RUBY call to action
  3. Scan to he first appearance of macOS

then you are encouraged to use rbenv or RVM to install Ruby.

But if you:

  1. Search the internet for "install ruby"
  2. Land on https://www.ruby-lang.org/en/documentation/installation/
  3. Scan for the first appearance of macOS

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:

  1. Delete the software using all the ways that didn't work.
  2. Find the project's website.
  3. Find some instructions on there.
  4. 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.

@VagishVela
Copy link
Contributor

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).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

2 participants