README.md in bogus-0.0.4 vs README.md in bogus-0.1.0

@@ -1,33 +1,69 @@
 # Bogus
 
+Bogus aims to make your unit tests more reliable by ensuring that you don't stub or mock methods that don't actually exist in the mocked objects.
+
 [![build status](https://secure.travis-ci.org/psyho/bogus.png)](http://travis-ci.org/psyho/bogus)
 [![Code Climate](https://codeclimate.com/github/psyho/bogus.png)](https://codeclimate.com/github/psyho/bogus)
 [![Coverage Status](https://coveralls.io/repos/psyho/bogus/badge.png?branch=master)](https://coveralls.io/r/psyho/bogus?branch=master)
 [![Gem Version](https://badge.fury.io/rb/bogus.png)](http://badge.fury.io/rb/bogus)
 [![Dependency Status](https://gemnasium.com/psyho/bogus.png)](https://gemnasium.com/psyho/bogus)
 
-## What is Bogus?
+## Example
 
-Bogus aims to make your unit tests more reliable by ensuring that you don't stub or mock methods that don't actually exist in the mocked objects.
+```ruby
+class PostRepository
+  def store(title)
+    # save a new post in the database
+  end
+end
 
-Bogus provides facilities to create *fakes* - test doubles that have the same interface as the doubled class.
+class PostAdder < Struct.new(:post_repository)
+  def add(title)
+    post = post_repository.store(title)
+    # do some stuff with the post
+  end
+end
 
-Another feature of Bogus is *safe stubbing*, which does not allow you to stub methods that don't exist or don't match the signature specified when stubbing.
+describe PostAdder do
+  fake(:post_repository)
 
-A unique feature of Bogus are the *contract tests*, which reduce the need for integrated tests to a minimum by ensuring that the things you stub match how the object really behaves.
+  it "stores the post" do
+    post_adder = PostAdder.new(post_repository)
+    
+    post_adder.add("Bogus is safe!")
 
+    post_repository.should have_received.store("Bogus is safe!")
+  end
+end
+```
+
+## Features
+
+* [Safe Stubbing][safe-stubbing] - Bogus does not allow you to stub methods that don't exist or don't match the stubbed signature.
+* [Fakes][fakes] - test doubles that have the same interface as the doubled class.
+* [Support for ActiveRecord models][ar-support] - Bogus comes with support for active record fields out of the box.
+* [Global fake configuration][global-configuration] - Decouple your fakes from class names and define default return values in one place.
+* [Contract tests][contract-tests] - a unique feature of Bogus, which reduces the need for integrated tests to a minimum by ensuring that the things you stub match how the object really behaves.
+
 ## Documentation
 
-[You can find our (executable) documentation on Relish.][docs]
+[You can find more detailed (and executable) documentation on Relish.][docs]
 
 ## License
 
 MIT. See the LICENSE file.
 
 ## Authors
 
 * [Adam Pohorecki](http://github.com/psyho)
 * [Paweł Pierzchała](http://github.com/wrozka)
+* [Piotr Szotkowski](https://github.com/chastell)
 * [Marek Nowak](https://github.com/yundt)
 
 [docs]: http://www.relishapp.com/bogus/bogus/docs 
+
+[safe-stubbing]: https://www.relishapp.com/bogus/bogus/docs/safe-stubbing
+[fakes]: https://www.relishapp.com/bogus/bogus/docs/fakes
+[ar-support]: https://www.relishapp.com/bogus/bogus/docs/configuration/fake-ar-attributes
+[global-configuration]: https://www.relishapp.com/bogus/bogus/docs/fakes/global-fake-configuration
+[contract-tests]: https://www.relishapp.com/bogus/bogus/docs/contract-tests