diff --git a/README.rdoc b/README.rdoc
index 3dc4dc5..93bff47 100644
--- a/README.rdoc
+++ b/README.rdoc
@@ -31,11 +31,12 @@ If you're using Rails + ActiveRecord + Bundler
     end
   end
 
-== Usage
+== Documentation, Guides & Examples
 
-Krzysiek Heród (aka {Netizer}[http://github.com/netizer]) wrote a nice {blog
-post}[http://dev.netizer.pl/transitions-state-machine-for-rails-3.html]
-about using Transitions in ActiveRecord.
+- {Online API Documentation}[http://rdoc.info/github/qoobaa/transitions/master/Transitions]
+- Krzysiek Heród (aka {Netizer}[http://github.com/netizer]) wrote a nice
+  {blog post}[http://dev.netizer.pl/transitions-state-machine-for-rails-3.html]
+  about using Transitions in ActiveRecord.
 
 == Copyright