README.md in dase-3.2.4 vs README.md in dase-3.2.5

@@ -1,6 +1,6 @@
-# Dase
+[![Build Status](https://secure.travis-ci.org/vovayartsev/dase.png)](http://travis-ci.org/vovayartsev/dase)
 
 ## Overview
 
 Dase gem provides 'includes_count_of' method on a relation, which works similar to ActiveRecord's 'includes' method.
 
@@ -14,26 +14,23 @@
 ```
 
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add this line to your Rails 3.2.x application's Gemfile:
 
-    gem 'dase', "~> 3.2.0"
+    gem 'dase', "~> 3.2.4"
 
-### Note on version numbers
-
-Dase version number correlates with the Active Record's versions number,
-which it has been tested with.
-E.g. the latest 3.2.* version of Dase will play nicely with the latest 3.2.* version of Active Record.
-Since it's a sort of a "hack", make sure you specified the version number for "dase" gem in your Gemfile.
-
 ## Usage
 
 ### Basic usage:
 
 ```
+  class Author
+    has_many :articles
+  end
+  
   Author.includes_count_of(:articles).find_each do |author|
     puts "#{author.name} has #{author.articles_count} articles published"
   end
 ```
 
@@ -44,42 +41,56 @@
 Author.includes_count_of(:articles, :conditions => {:year => 2012})   # counts only articles in year 2012
 ```
 
 ### Using scope merging
 ```
-scope = Article.where(:year => 2012)
-Author.includes_count_of(:articles, :only => scope)   # counts only articles in year 2012
-```
+class Article
+  belongs_to :author
+  scope this_year, lambda { where(:year => 2012) }
+end 
 
-### Using block syntax
+results = Author.includes_count_of(:articles, :only => Article.this_year)   
+results.first.articles_count  # => # number of articles of given Author for year 2012 only
 ```
-Author.includes_count_of(:articles){ where(:year => 2012) }        # in the block, 'self' is a Relation instance
-Author.includes_count_of(:articles){ |scope| scope.where(:year => 2012) }   # 'self' is the same inside and outside the block
-```
+This is achieved by merging the association scope with the scope provided as ":only => ..." option. 
+No additional checks are performed, and providing the association of proper type is solely your responsibility.
 
+
 ### Renaming counter column
 ```
 sites = WebSite.includes_count_of(:users, :conditions => {:role => 'admin'}, :as => :admins_count)   
 sites.each { |site| puts "Site #{site.url} has #{site.admins_count} admin users" }
 ```
 
+## Compatibility
 
-### Known problems
+### Rails versions
 
-Dase doesn't support polymorphism.
+This gem is for Rails 3.2.x . Earlier versions are not supported.
 
+Note: the Dase gem version number correlates with the Active Record's versions number,
+which it has been tested with.
+E.g. the latest 3.2.* version of Dase will play nicely with the latest 3.2.* version of Active Record.
+Since dase gem is a sort of a "hack", make sure you specified the version number for "dase" gem in your Gemfile.
+
+### Polymorphic associations and HasManyThrough associations
+
+Polymorphic associations and HasManyThrough associations support should work, but it is not tested quite well.
+Bug reports and pull requests are very welcome.
+
+### jRuby support
+
+Not yet
+
 ## How it works
 
 Here's a pseudo-code that gives an idea on how it works internally
 ```
   counters_hash = Article.where(:year => 2012).count(:group => :author_id)
   Author.find_each do |author|
     puts "#{author.name} has #{counters_hash[author.id] || 0} articles published"
   end
 ```
-
-
-
 
 ## Name origin
 
 The gem is named by the german mathematician [Johann Dase](http://en.wikipedia.org/wiki/Zacharias_Dase),
 who was a mental calculator - he could count and multiply numbers very quickly.