explain that removing broken gems can fix things

1 files changed, 8 insertions, 2 deletions

diff --git a/ISSUES.md b/ISSUES.md
index cb599020b3..49606e14a9 100644
--- a/ISSUES.md
+++ b/ISSUES.md
@@ -19,7 +19,7 @@ Please open a ticket with Heroku if you're having trouble deploying. They have a
 After reading the documentation, try these troubleshooting steps:
 
     # remove user-specific gems and git repos
-    rm -rf ~/.bundle/ ~/.gem/
+    rm -rf ~/.bundle/ ~/.gem/bundler/ ~/.gems/cache/bundler/
 
     # remove system-wide git repos and git checkouts
     rm -rf $GEM_HOME/bundler/ $GEM_HOME/cache/bundler/
@@ -33,6 +33,10 @@ After reading the documentation, try these troubleshooting steps:
     # remove the saved resolve of the Gemfile
     rm -rf Gemfile.lock
 
+    # uninstall the rubygems-bundler and open_gem gems
+    rvm gemset use global # if using rvm
+    gem uninstall rubygems-bundler open_gem
+
     # try to install one more time
     bundle install
 
@@ -49,9 +53,11 @@ The Bundler team needs to know some things in order to diagnose and hopefully fi
   - What version of Ruby you are using (run `ruby -v`)
   - What version of Rubygems you are using (run `gem -v`)
   - Whether you are using RVM, and if so what version (run `rvm -v`)
-  - Whether you have the `rubygems-bundler` gem, which can break gem binares (run `gem list rubygems-bundler`)
+  - Whether you have the `rubygems-bundler` gem, which can break gem executables (run `gem list rubygems-bundler`)
   - Whether you have the `open_gem` gem, which can cause rake activation conflicts (run `gem list open_gem`)
 
+If you have either `rubygems-bundler` or `open_gem` installed, please try removing them and then following the troublshooting steps above before opening a new ticket.
+
 If you are using Rails 2.3, please also include:
 
   - Your boot.rb file