summaryrefslogtreecommitdiff
path: root/doc/TROUBLESHOOT.md
diff options
context:
space:
mode:
authorAzul <azul@riseup.net>2016-07-04 21:26:46 +0200
committerAzul <azul@riseup.net>2016-07-05 08:56:05 +0200
commit6b08e8c89d26225786736ad69ba335b275a1a048 (patch)
tree11307fe8684f62a9302b6243ef2be2614fac1a30 /doc/TROUBLESHOOT.md
parent638acc59a241e141cf0fc9ccbf4e3c5578b98f0c (diff)
[doc] update install documentation
Diffstat (limited to 'doc/TROUBLESHOOT.md')
-rw-r--r--doc/TROUBLESHOOT.md14
1 files changed, 10 insertions, 4 deletions
diff --git a/doc/TROUBLESHOOT.md b/doc/TROUBLESHOOT.md
index f3db006..0e2957d 100644
--- a/doc/TROUBLESHOOT.md
+++ b/doc/TROUBLESHOOT.md
@@ -13,15 +13,19 @@ Here are some less common issues you might run into when installing Leap Web.
Make sure bundler is installed. `gem list bundler` should list `bundler`.
You also need to be able to access the `bundler` executable in your PATH.
-## Outdated version of rubygems ##
+## Incompatible ruby version ##
-### Error Messages ###
+### Detecting the problem ###
+The rubyversion we use for development and testing is noted in the file
+
+ .ruby-version
-`bundler requires rubygems >= 1.3.6`
+It should match what `ruby --version` prints.
### Solution ###
-`gem update --system` will install the latest rubygems
+Install the matching ruby version. For some operation systems this may require
+the use of rbenv or rvm.
## Missing development tools ##
@@ -42,5 +46,7 @@ Some gem dependencies might not compile because they lack the needed c libraries
### Solution ###
Install the libraries in question including their development files.
+Usually the missing library is mentioned in the error message. Searching the
+internet for similar errors is a good starting point aswell.