README.md in popular-0.3.0 vs README.md in popular-0.3.1

@@ -1,16 +1,15 @@
 # Popular
 [![Gem Version](https://badge.fury.io/rb/popular.png)](http://badge.fury.io/rb/popular)
 [![Build Status](https://travis-ci.org/thejchap/popular.svg?branch=master)](https://travis-ci.org/thejchap/popular)
 [![Code Climate](https://codeclimate.com/github/thejchap/popular.png)](https://codeclimate.com/github/thejchap/popular)
 [![Code Coverage](https://codeclimate.com/github/thejchap/popular/coverage.png)](https://codeclimate.com/github/thejchap/popular)
+[![Inline docs](http://inch-pages.github.io/github/thejchap/popular.png)](http://inch-pages.github.io/github/thejchap/popular)
 [![Dependency Status](https://gemnasium.com/thejchap/popular.svg)](https://gemnasium.com/thejchap/popular)
 
 Popular is a friendship gem designed for Rails/ActiveRecord models.
 
-### THIS IS A VERY YOUNG GEM. YOU HAVE BEEN WARNED
-
 ## Installation
 
 Add this line to your application's Gemfile:
 
     gem 'popular'
@@ -21,16 +20,64 @@
 
 Or install it yourself as:
 
     $ gem install popular
 
+### Database Migration
+
+Popular uses a friendships table to store friendship relationships.
+To get up and running, use the following command:
+
+    rails g popular:migration
+    rake db:migrate
+
 ## Usage
 
-TODO: Write usage instructions here
+### Model
 
+To get started using Popular, simply add `popular` to your model, (ie: `app/models/user.rb`)
+
+```ruby
+class User < ActiveRecord::Base
+  popular
+end
+
+@sam = User.create name: "Samuel"
+@jackson = User.create name: "Jackson"
+
[e-mail]_with? @jackson #=> false
[e-mail] @jackson
[e-mail]_with? @jackson #=> true
[e-mail] @jackson
[e-mail]_with? @jackson #=> false
+```
+
+### Callbacks
+
+Popular provides callbacks that are fired around friendship creation. Available callbacks are:
+  - after_befriend
+  - before_befriend
+
+
+```ruby
+class User < ActiveRecord::Base
+  popular
+  after_befriend :notify
+
+  def notify
+    puts "Friendship created successfully"
+  end
+end
+
+@justin = User.create name: "Justin"
+@jenny = User.create name: "Jenny"
+
[e-mail] @jenny #=> "Friendship created successfully"
+```
+
 ## Contributing
 
-1. Fork it ( http://github.com/<my-github-username>/popular/fork )
+1. Fork it ( http://github.com/thejchap/popular/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request