README.markdown in selenium-client-1.2.3 vs README.markdown in selenium-client-1.2.4

@@ -14,27 +14,40 @@
     sudo gem install selenium-client
 
 Features
 ========
 
- * Backward compatible with the old-fashioned, XSL generated Selenium Ruby API.
-   See [the generated driver](http://selenium-client.rubyforge.org/classes/Selenium/Client/GeneratedDriver.html) to get an extensive reference.
+* Backward compatible with the old-fashioned, XSL generated Selenium Ruby API.
+ See [the generated driver](http://selenium-client.rubyforge.org/classes/Selenium/Client/GeneratedDriver.html) to get an extensive reference.
    
- * Idiomatic interface to the Selenium API.
+* Idiomatic interface to the Selenium API.
   See [the Idiomatic module](http://selenium-client.rubyforge.org/classes/Selenium/Client/Idiomatic.html)
   for more details.
  
- * Convenience methods for AJAX.
-   See the [Extensions](http://selenium-client.rubyforge.org/classes/Selenium/Client/Extensions.html)
-   for more details.
-   
- * Leveraging latest innovations in Selenium Remote Control (screenshots, log captures, ...)
+* Convenience methods for AJAX.
+ See the [Extensions](http://selenium-client.rubyforge.org/classes/Selenium/Client/Extensions.html)
+  for more details.
+
+* Flexible wait semantics inline with the trigerring action. e.g.
  
- * Robust Rake task to start/stop the Selenium Remote Control server. More details in the next section.
+  * `click 'the_button_id', :wait_for => :page`
+  * `click 'the_button_id', :wait_for => :ajax`
+  * `click 'the_button_id', :wait_for => :element, :element => 'new_element_id'`
+  * `click 'the_button_id', :wait_for => :no_element, :element => 'disappearing_element_id'`
+  * `click 'the_button_id', :wait_for => :text, :text => 'New Text'`
+  * `click 'the_button_id', :wait_for => :no_text, :text => 'Disappearing Text'`
+  * `click 'the_button_id', :wait_for => :effects`
+  * `click 'the_button_id', :wait_for => :condition, :javascript => "some arbitrary javascript expression"`
 
- * State-of-the-art reporting for RSpec.
+  Check out the `click`, `go_back` and `wait_for` methods of the [Idiomatic Module](http://selenium-client.rubyforge.org/classes/Selenium/Client/Idiomatic.html)
+           
+* Leveraging latest innovations in Selenium Remote Control (screenshots, log captures, ...)
+ 
+* Robust Rake task to start/stop the Selenium Remote Control server. More details in the next section.
 
+* State-of-the-art reporting for RSpec.
+
 Plain API
 =========
  
  Selenium client is just a plain Ruby API, so you can use it wherever you can use Ruby. 
  
@@ -129,12 +142,13 @@
 
      before(:each) do
        selenium_driver.start_new_browser_session
      end
 
-     after(:each) do
-       selenium_driver.close_current_browser_session
+     # The system capture need to happen BEFORE closing the Selenium session 
+     config.append_after(:each) do    
+       @selenium_driver.close_current_browser_session
      end
 
      it "can find Selenium" do    
        page.open "/"
        page.title.should eql("Google")
@@ -200,8 +214,23 @@
      t.verbose = true
     end
 
  You can then get cool reports like [this one](http://ph7spot.com/examples/selenium_rspec_report.html)
 
+Contribute and Join the Fun!
+============================
 
+  We welcome new features, add-ons, bug fixes, example, documentation, etc. Make the gem work the way you
+  envision!
+  
+* I recommend cloning the selenium-client [reference repository](http://github.com/ph7/selenium-client/tree/master)
+  I you are more of a SVN guy, the same code also lives at [OpenQA](http://svn.openqa.org/svn/selenium-rc/trunk/clients/ruby)
+  
+* You can also check out the [RubyForge page](http://rubyforge.org/projects/selenium-client) and the [RDoc](http://selenium-client.rubyforge.org)
+  
+* We also have a [continuous integration server](http://xserve.openqa.org:8080/view/Ruby%20Client)
+
+
+  
+