README.md in simplecov-tdd-0.1.0 vs README.md in simplecov-tdd-0.2.0

@@ -1,9 +1,11 @@
 # Simplecov::Tdd
 
-A SimpleCov formatter for test driven development
+A SimpleCov formatter for test driven development. Displays code coverage results in the console for single files
 
+![Example TDD](https://github.com/joshmfrankel/simplecov-tdd/blob/master/example.gif)
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -19,17 +21,74 @@
     $ gem install simplecov-tdd
 
 ## Usage
 
 1. Ensure that you've configured your project to SimpleCov's _Getting Started_ section: https://github.com/colszowka/simplecov#getting-started
-2. Set your `SimpleCov.formatter` to the following:
+2. Set your SimpleCov configuration to the following:
 
 ```ruby
+require "simplecov/tdd"
 SimpleCov.formatter = Simplecov::Formatter::Tdd
+# OR use multi-formatter
+SimpleCov.formatters = SimpleCov::Formatter::MultiFormatter.new([
+  SimpleCov::Formatter::HTMLFormatter,
+  Simplecov::Formatter::Tdd
+])
 ```
-3. Run your tests using rspec path/to/file_spec.rb or guard
+
+Simple Setup:
+
+```ruby
+# /spec/spec_helper.rb
+require "simplecov"
+require "simplecov/tdd"
+SimpleCov.formatter = SimpleCov::Formatter::Tdd
+SimpleCov.start 'rails'
+```
+
+3. Run your tests using `rspec path/to/file_spec.rb` or `guard`
 4. Fix the missing coverage
 5. 💰 Profit! 💰
+
+## Configuration options
+
+There are a few configuration options that may be set before formatting is called.
+Generally you may place these after `SimpleCov.formatter` or `SimpleCov.formatters = SimpleCov::Formatter::MultiFormatter.new` in your setup.
+
+### output_style (default: :simple)
+When there are lines missing coverage, this option determines how to display output.
+The accepted values are `:simple` (default) or `:verbose`.
+
+```ruby
+SimpleCov::Formatter::Tdd.output_style = :verbose
+```
+
+Here's an example of what :verbose output looks like:
+
+```ruby
+app/models/matched_90.rb
+90.0% coverage, 167 total lines
+
+The following 2 lines have missing coverage:
+[5, 25]
+
+line | source code
+-------------------
+5 => obj.is_a?(SomeClass)
+25 => SomeClass.explode!
+```
+
+### debug_mode (default: false)
+This is useful for determining if the current file being tested doesn't have
+a match from SimpleCov's file list.
+
+```ruby
+SimpleCov::Formatter::Tdd.debug_mode = true
+```
+
+## Future Features
+
+* Support for minitest
 
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.