summaryrefslogtreecommitdiff
path: root/ISSUES.md
diff options
context:
space:
mode:
authorAndre Arko <andre@arko.net>2011-05-25 12:17:14 -0700
committerAndre Arko <andre@arko.net>2011-05-25 12:17:14 -0700
commit2e6fcbde77b92ade526068251a81e9f55d4a950b (patch)
tree677fad1c3d7fd55c16b752d981df0ee84d629333 /ISSUES.md
parentdcaf089dc88b8f2316260156983990c48e3e33a1 (diff)
downloadbundler-2e6fcbde77b92ade526068251a81e9f55d4a950b.tar.gz
Update issues with better instructions
Diffstat (limited to 'ISSUES.md')
-rw-r--r--ISSUES.md26
1 files changed, 14 insertions, 12 deletions
diff --git a/ISSUES.md b/ISSUES.md
index e61e630fa8..0c14d65714 100644
--- a/ISSUES.md
+++ b/ISSUES.md
@@ -2,7 +2,9 @@
## Troubleshooting
-Instructions for common Bundler use-cases can be found on the [Bundler documentation site](http://gembundler.com/v1.0/). Detailed information about each Bundler command, including help with common problems, can be found in the [Bundler man pages](http://gembundler.com/man/bundle.1.html).
+Instructions for common Bundler use-cases can be found on the [Bundler documentation site](http://gembundler.com/v1.0/).
+
+Detailed information about each Bundler command, including help with common problems, can be found in the [Bundler man pages](http://gembundler.com/man/bundle.1.html).
After reading the documentation, try these troubleshooting steps:
@@ -26,23 +28,23 @@ After reading the documentation, try these troubleshooting steps:
## Reporting unresolved problems
-If you are still having problems, please report issues to the [Bundler issue tracker](http://github.com/carlhuda/bundler/issues/).
-
-Instructions that allow the Bundler team to reproduce your issue are vitally important. When you report a bug, please create a gist of the following information and include a link in your ticket:
+Instructions that allow the Bundler team to reproduce your issue are vitally important. When you report a bug, please include the following information:
- - What version of bundler you are using
- - What version of Ruby you are using
- - What version of Rubygems you are using
- - Whether you are using RVM, and if so what version
+ - The command you ran
+ - Exception backtrace(s), if any
- Your Gemfile
- Your Gemfile.lock
- - If you are on 0.9, whether you have locked or not
- - If you are on 1.0, the result of `bundle config`
- - The command you ran to generate exception(s)
- - The exception backtrace(s)
+ - Your Bundler configuration settings (run `bundle config`)
+ - What version of bundler you are using (run `bundle -v`)
+ - 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`)
+
If you are using Rails 2.3, please also include:
- Your boot.rb file
- Your preinitializer.rb file
- Your environment.rb file
+
+[Create a gist](https://gist.github.com) containing all of that information, then visit the [Bundler issue tracker](https://github.com/carlhuda/bundler) and create a new ticket describing your problem and linking to your gist.