README.md in liner-0.0.1 vs README.md in liner-0.1.0

@@ -1,9 +1,50 @@
 # Liner
 
-TODO: Write a gem description
+Lay a liner for your basic Ruby classes. Basically, it's a solid foundation for a PORO (Plain Old Ruby Object). A Liner is something like a more flexible Struct or a less magical OpenStruct, with enhanced inheritability.
 
+## Usage
+
+You can setup a Liner based class in any of these equivalent ways:
+
+```ruby
+Engine = Liner.new(:layout, :fuel)
+```
+```ruby
+class Engine < Liner.new(:layout, :fuel)
+end
+```
+```ruby
+class Engine
+  liner :layout, :fuel
+end
+```
+
+It comes with a hash based initializer and a nice inspector.
+```ruby
+e = Engine.new(layout: 'V8', fuel: "gasoline") # => #<Engine layout="V8", fuel="gasoline">
+```
+
+Attribute getters and setters are built in.
+```ruby
+e.fuel # => "gasoline"
+e.fuel = "diesel" # => "diesel"
+```
+
+Attributes are accessible via hash-style lookup too.
+```ruby
+e[:layout] # => "V8"
+e[:layout] = "V6" # => "V6"
+e[:foo] = "Bar" # => ArgumentError: Invalid liner attribute: 'foo'
+```
+
+Equality methods are also availble.
+```ruby
+e.eql? Engine.new(layout: 'I4') # => false
+e == Engine.new(layout: 'V6', fuel: 'diesel') # => true
+```
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
     gem 'liner'
@@ -14,12 +55,10 @@
 
 Or install it yourself as:
 
     $ gem install liner
 
-## Usage
 
-TODO: Write usage instructions here
 
 ## Contributing
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)