README.md in outbox-rails-0.0.1 vs README.md in outbox-rails-0.1.0

@@ -1,27 +1,71 @@
-# Outbox::Rails
+Outbox::Rails
+=============
 
-TODO: Write a gem description
+[![Gem Version](https://badge.fury.io/rb/outbox-rails.png)](http://badge.fury.io/rb/outbox-rails)
 
-## Installation
+Rails Railtie for sending email, SMS, and push notifications using the [Outbox](https://github.com/localmed/outbox) gem. Please view the [Outbox documentation](https://github.com/localmed/outbox) to understand the philosophy behind this interface and how to use it.
 
+Installation
+------------
+
 Add this line to your application's Gemfile:
 
-    gem 'outbox-rails'
+``` ruby
+gem 'outbox-rails'
+```
 
 And then execute:
 
-    $ bundle
+``` bash
+$ bundle
+```
 
 Or install it yourself as:
 
-    $ gem install outbox-rails
+``` bash
+$ gem install outbox-rails
+```
 
-## Usage
+Usage
+-----
 
-TODO: Write usage instructions here
+Outbox::Notifier uses a very similar interface to ActionMailer.
 
-## Contributing
+First, define a notifier in `app/notifiers`:
+
+``` ruby
+class AccountNotifier < Outbox::Notifier
+  default email: { from: '[e-mail]' },
+          sms: { from: '[phone]' }
+
+  def welcome
+    # Compose message types using the Outbox::Message interface
+    email do
+      subject 'Welcome to our App!'
+    end
+
+    sms do
+      body 'Welcome to our App!'
+    end
+
+    # Render the body of the message. This is analogous to ActionMailer::Base#mail,
+    # but unlike in ActionMailer, #render_message is not required.
+    render_message
+  end
+end
+```
+
+Send a message using the `deliver` method:
+
+```ruby
+# Unlike ActionMailer, deliver takes a single argument that defines the recipients
+# for the message types you want to send.
+AccountNotifier.welcome.deliver email: '[e-mail]', sms: '[phone]'
+```
+
+Contributing
+------------
 
 1. Fork it
 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`)