README.rdoc in capybara-0.1.2 vs README.rdoc in capybara-0.1.3

@@ -8,15 +8,23 @@
 such as Rails, Sinatra or Merb. It is inspired by and aims to replace Webrat as
 a DSL for interacting with a webapplication. It is agnostic about the driver
 running your tests and currently comes bundled with rack-test, Culerity and
 Selenium support built in.
 
-== Disclaimer:
+== Install:
 
-Capybara is alpha level software, don't use it unless you're prepared to get
-your hands dirty.
+Capybara is hosted on Gemcutter, install it with:
 
+    sudo gem install capybara
+
+== Development:
+
+* Source hosted at {GitHub}[http://github.com/jnicklas/capybara].
+* Please direct questions, discussions at the {mailing list}[http://groups.google.com/group/ruby-capybara].
+* Report issues on {GitHub Issues}[http://github.com/jnicklas/capybara/issues]
+* Pull requests are very welcome!
+
 == Using Capybara with Cucumber
 
 Capybara is built to work nicely with Cucumber. The API is very similar to
 Webrat, so if you know Webrat you should feel right at home. Remove any
 references to Webrat from your <tt>env.rb</tt>, if you're using Rails, make sure to set
@@ -143,22 +151,28 @@
       session.fill_in 'Login', :with => '[e-mail]'
       session.fill_in 'Password', :with => 'password'
     end
     session.click_link 'Sign in'
 
-== Install:
+== XPath and CSS
 
-Capybara is hosted on Gemcutter, install it with:
+Capybara does not try to guess what kind of selector you are going to give it,
+if you want to use CSS with your 'within' declarations for example, you'll need
+to do:
+    
+    within(:css, 'ul li') { ... }
 
-    sudo gem install capybara
+Alternatively you can set the default selector to CSS, which may help if you are
+moving from Webrat and used CSS a lot, or simply generally prefer CSS:
 
+    Capybara.default_selector = :css
+    within('ul li') { ... }
+
 == Gotchas:
 
 * Install JRuby and the 'celerity' gem, version 0.7.4 (0.7.5 has a bug with
-  password fields) under JRuby for Culerity support. Also you'll need to install
-  teh edge version of Culerity until a new gem release becomes available, since
-  0.2.3 does not work (at all!) with Capybara.
+  password fields) under JRuby for Culerity support.
 
 * Everything is *case sensitive*. Capybara heavily relies on XPath, which
   doesn't support case insensitive searches.
 
 * The <tt>have_tag</tt> and <tt>have_text</tt> matchers in RSpec-Rails are not
@@ -183,9 +197,17 @@
   since we're not using Rails' integration testing.
 
 * <tt><a href="#"></tt> Will cause problems under rack-test, please do
   <tt><a href="/same/url#"></tt> instead. You can achieve this in Rails with
   <tt>link_to('foo', :anchor => '')</tt>
+
+== Contributors:
+
+The following people have dedicated their time and effort to Capybara:
+
+* Jonas Nicklas
+* Dennis Rogenius
+* Rob Holland
 
 == License:
 
 (The MIT License)
 
\ No newline at end of file