README.md in bbq-0.0.3 vs README.md in bbq-0.0.4
- old
+ new
@@ -194,9 +194,39 @@
user.register_and_login
user.see!("Stuff after auth")
end
```
+Caveats
+=======
+
+<h2>Timeout::Error</h2>
+
+If you simulate multiple users in your tests and spawn multiple browsers with selenium it might
+be a good idea to use `Mongrel` instead of `Webrick` to create application server.
+We have experienced some problems with `Webrick` that lead to `Timeout::Error` exception
+when user/browser that was inactive for some time (due to other users/browsers
+activities) was requested to execute an action.
+
+Put this code into a file loaded before running any acceptance scenario like:
+`test/test_helper.rb` or `spec/spec_helper.rb`:
+
+```ruby
+Capybara.server do |app, port|
+ require 'rack/handler/mongrel'
+ Rack::Handler::Mongrel.run(app, :Port => port)
+end
+```
+
+Add `mongrel` to your `Gemfile`:
+
+```ruby
+# In test group if you want it to
+# be used only in tests and not in your development mode
+# ex. when running 'rails s'
+gem 'mongrel', "1.2.0.pre2", :require => false
+```
+
Development environment
=======================
```
bundle install