README.md in sideband-1.0.0 vs README.md in sideband-1.0.1

@@ -1,9 +1,15 @@
 # Sideband
 
-TODO: Write a gem description
+Run simple jobs in a separate sideband thread.
 
+Sideband makes it easy to pass small jobs off to a separate in-process thread. It makes no attempt to handle errors, nor return any results. Its primary focus is queueing up potentially IO blocking bits of code, where the results of which are not necessarily vital to your application's business logic.
+
+Use cases:
+* 
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
     gem 'sideband'
@@ -16,10 +22,60 @@
 
     $ gem install sideband
 
 ## Usage
 
-TODO: Write usage instructions here
+To be used Sideband needs to be intialized, typically in an Rails initializer (but can be used outside of Rails).
+
+```ruby
+Sideband.initialize!
+```
+
+In theory you can create one Sideband thread per thread, however it's most useful in your main thread.
+
+To pass work off to Sideband, you can add anything that is callable (procs, lambdas, workers) to its queue:
+
+```ruby
+Sideband.queue << -> { Something.expensive }
+```
+
+Sideband will queue the work, then return immediately.  The work will get called whenever the thread scheduler schedules the worker thread--typically after your controller renders.
+
+Sideband is truly fire-and-forget, any exceptions are caught and thrown away.  If you want to handle exception, you should probably do so in a custom worker.
+
+```ruby
+class MetricWorker < Sideband::Worker
+  def initialize(params)
+    @params = params
+  end
+
+  def call
+    Work.create!(@params)
+  rescue ActiveRecord::RecordInvalid
+    Rails.logger.error("Could not save Metric: #{@params}")
+  end
+end
+
+Sideband.queue << MetricWorker.new(params[:metric])
+
+ # or Sideband::Workers can enqueue themselves
+
+Metricworker.new(params[:metric]).enqueue
+```
+
+## Use Cases
+
+
+```ruby
+@user = User.create(params[:user])
+Sideband.queue << -> { UserMailer.welcome_email(@user).deliver }
+render :welcome
+```
+
+## Code Status
+
+[![Build Status](https://api.travis-ci.org/mje113/sideband.png)](http://travis-ci.org/mje113/sideband)
+[![Code Climate](https://codeclimate.com/github/mje113/sideband.png)](https://codeclimate.com/github/mje113/sideband)
 
 ## Contributing
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)