maverick/docbrown
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update Ruby Section and Add Additional Error (#12669)

Browse source 
Adding additional information to the Ruby section to help contributors who are not used to Ruby.
Also explicitly stating that the project must be cloned and forked before using rbenv install $(cat .ruby-version)

Also adding a common error Nick and I encountered with a solution.
This commit is contained in:
Christina 2021-02-12 10:45:34 -06:00 • committed by GitHub
parent a64fffd3b1
commit bcbeb66c98
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 15 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
docs/installation/mac.md
View file

@ -8,14 +8,18 @@ title: macOS
### Ruby
1. If you don't already have a Ruby version manager, we highly recommend
[rbenv](https://github.com/rbenv/rbenv). Please follow their
[installation guide](https://github.com/rbenv/rbenv#installation).
1. **Note:** MacOS ships with a version of Ruby, needed for various operating systems.
To avoid causing an issue with your operating system you should use a version manager for Ruby.
If you don't already have a Ruby version manager, we highly recommend [rbenv](https://github.com/rbenv/rbenv). This will allow you to have different versions running on a per project basis. The MacOS system version of Ruby will stay intact while giving you the ability to use the version needed for this Forem project.
Please follow their [installation guide](https://github.com/rbenv/rbenv#installation).
2. With the Ruby version manager, install the Ruby version listed on our badge.
(i.e. with rbenv: `rbenv install $(cat .ruby-version)`)
**Note:** The repository must be forked and cloned before running the `rbenv install $(cat .ruby-version)` command.
### Yarn
Please refer to their [installation guide](https://yarnpkg.com/en/docs/install).
### PostgreSQL
@ -236,6 +240,13 @@ your local Elasticsearch installation, for example:
### Possible error messages
**Error:**
`rbenv install hangs at ruby-build: using readline from homebrew`
**_Solution:_**
[Stackoverflow answer](https://stackoverflow.com/questions/63599818/rbenv-install-hangs-at-ruby-build-using-readline-from-homebrew)
`RUBY_CONFIGURE_OPTS=--with-readline-dir="$(brew --prefix readline)" rbenv install 2.0.0`
**Error:**
`__NSPlaceholderDate initialize] may have been in progress in another thread when fork() was called`