README.md in heredity-0.1.1 vs README.md in heredity-0.1.2

@@ -1,8 +1,8 @@
 # Heredity
 
-TODO: Write a gem description
+Heredity adds on_inherit hooks to Ruby which providing a clean way execute code on inherited classes without the need to override `inherited`. It also adds the ability to specify class instance variables that should be copied to subclasses.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
@@ -16,10 +16,38 @@
 
     $ gem install heredity
 
 ## Usage
 
-TODO: Write usage instructions here
+#### Inheritance hooks
+
+To use Heredity's inheritance hooks, simply call `on_herit` with a block:
+
+```Ruby
+class Foo
+  on_inherit do
+    puts 'Child of Foo!'
+  end
+end
+```
+
+This is very useful for injecting behavior into subclasses that is dependent on class state (e.g. behavior that relies on the columns of an active record model).
+
+#### Class instance variables
+
+Because class instance variables in Ruby are not inherited (and rightfully so), Heredity provides the ability to define specific class instance variables that should be inherited. To define inheritable attributes:
+
+```Ruby
+class Foo
+  include Heredity
+
+  # Define inheritable attributes
+  inheritable_attributes :bar
+
+  # Initialize inheritable attributes (so there's something to copy).
+  self.bar = {}
+end
+```
 
 ## Contributing
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)