README.md in naturally-1.0.2 vs README.md in naturally-1.0.3

@@ -2,10 +2,15 @@
 
 Natural sorting with support for legal document numbering. 
 See [Counting to 10 in Californian](http://www.weblaws.org/blog/2012/08/counting-from-1-to-10-in-californian/)
 for the motivations to make this library.
 
+The core of the search is [from here](https://github.com/ahoward/version_sorter). I then made
+several changes to handle the particular types of numbers that come up in statutes, such
+as *335.1, 336, 336a*, etc.
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
     gem 'naturally'
@@ -16,12 +21,39 @@
 
 Or install it yourself as:
 
     $ gem install naturally
 
+
 ## Usage
 
-See the spec for examples.
+```Ruby
+# Sort a simple array of strings
+Naturally.sort(["1.1", "1.10", "1.2"])  # => ["1.1", "1.2", "1.10"]
+
+# Sort an array of objects by one attribute
+Thing = Struct.new(:number, :name)
+objects = [
+  Thing.new('1.1', 'color'),
+  Thing.new('1.2', 'size'),
+  Thing.new('1.1.1', 'opacity'),
+  Thing.new('1.1.2', 'lightness'),
+  Thing.new('1.10', 'hardness'),
+  Thing.new('2.1', 'weight'),
+  Thing.new('1.3', 'shape')
+  ]
+objects.sort_by{ |o| Naturally.normalize(o.number) }
+# => [#<struct Thing number="1.1", name="color">,
+      #<struct Thing number="1.1.1", name="opacity">,
+      #<struct Thing number="1.1.2", name="lightness">,
+      #<struct Thing number="1.2", name="size">,
+      #<struct Thing number="1.3", name="shape">,
+      #<struct Thing number="1.10", name="hardness">,
+      #<struct Thing number="2.1", name="weight">]
+```
+
+See [the spec for more examples](https://github.com/dogweather/naturally/blob/master/spec/naturally_spec.rb).
+
 
 ## Contributing
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)