README.md in louche-0.0.1 vs README.md in louche-0.1

@@ -1,6 +1,15 @@
-# Louche
+<p align="center">
+  <a href="https://github.com/mirego/microscope">
+    <img src="http://i.imgur.com/FhNZIjg.png" alt="Louche" />
+  </a>
+  <br />
+  Louche adds common validators for ActiveModel/ActiveRecord classes.
+  <br /><br />
+  <a href="https://rubygems.org/gems/louche"><img src="https://badge.fury.io/rb/louche.png" /></a>
+  <a href="https://travis-ci.org/mirego/louche"><img src="https://travis-ci.org/mirego/louche.png?branch=master" /></a>
+</p>
 
 ---
 
 ## Installation
 
@@ -12,13 +21,83 @@
 
 ## Usage
 
 Louche provides a few validators to use in your ActiveModel/ActiveRecord classes:
 
-* `EmailValidator`
-* `URLValidator`
-* `PhoneNumberValidator`
-* `PostalCodeValidator`
+### `EmailValidator`
+
+```ruby
+class User < ActiveRecord::Base
+  validates :email, email: true
+end
+
+User.new(email: '[e-mail]').valid? # => true
+User.new(email: 'foo@example').valid? # => false
+```
+
+### `URLValidator`
+
+```ruby
+class User < ActiveRecord::Base
+  validates :website, url: true
+end
+
+User.new(website: 'http://example.com').valid? # => true
+User.new(website: 'example.$$$').valid? # => false
+```
+
+### `PhoneNumberValidator`
+
+```ruby
+class User < ActiveRecord::Base
+  validates :phone_number, phone_number: true
+end
+
+user = User.new(phone_number: '514 555-2525')
+user.valid? # => true
+user.phone_number # => '5145552525'
+
+user = User.new(phone_number: '555-2525')
+user.valid? # => false
+user.phone_number # '5552525'
+```
+
+### `PostalCodeValidator`
+
+```ruby
+class User < ActiveRecord::Base
+  validates :postal_code, postal_code: true
+end
+
+user = User.new(postal_code: 'G0R 2T0')
+user.valid? # => true
+user.postal_code # => 'G0R2T0'
+
+user = User.new(postal_code: 'L -0- L')
+user.valid? # => false
+user.postal_code # => 'L0L'
+```
+
+### `ArrayValidator`
+
+```ruby
+class Tag < Struct.new(:name)
+  def valid?
+    name.present?
+  end
+end
+
+class User < ActiveRecord::Base
+  validates :tags, array: true
+
+  def tags=(tags)
+    super tags.map { |tag| Tag.new(tag) }
+  end
+end
+
+User.new(tags: ['food', 'beer', 'code']).valid? # => true
+User.new(tags: ['food', '', 'code']).valid? # => false
+```
 
 ## License
 
 `Louche` is © 2014 [Mirego](http://www.mirego.com) and may be freely distributed under the [New BSD license](http://opensource.org/licenses/BSD-3-Clause).  See the [`LICENSE.md`](https://github.com/mirego/louche/blob/master/LICENSE.md) file.