Merge pull request #426 from smridge/add-reference-to-contributing-doc

Update Contributing Doc with Bundle Install Troubleshooting
This commit is contained in:
Blake Erickson 2021-05-13 05:09:51 -06:00 committed by GitHub
commit 985f444834
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -29,6 +29,24 @@ npm install
cd -
```
### Troubleshooting:
- `libv8` or `therubyracer` MacOS Catalina/Big Sur install issues:
```
An error occurred while installing libv8 (3.16.14.19), and Bundler cannot continue.
Make sure that `gem install libv8 -v '3.16.14.19' --source 'https://rubygems.org/'` succeeds before bundling.
An error occurred while installing therubyracer (0.12.3), and Bundler cannot continue.
Make sure that `gem install therubyracer -v '0.12.3' --source 'https://rubygems.org/'` succeeds before bundling.
```
Try, [reference](https://stackoverflow.com/a/62413041/7477016):
```
brew install v8@3.15
bundle config build.libv8 --with-system-v8
bundle config build.therubyracer --with-v8-dir=$(brew --prefix v8@3.15)
bundle
```
## Test
Initialize the rswag-ui repo with assets.
```