README.md in markov-rb-0.1.7 vs README.md in markov-rb-0.1.8

@@ -6,18 +6,23 @@
 
 [![Code Climate GPA](https://codeclimate.com/github//markov/badges/gpa.svg)](https://codeclimate.com/github//markov)
 
 ## Description
 
-TODO: Description
+Character-oriented Markov processes for text generation
 
 ## Features
 
 ## Examples
 
     require 'markov'
+    chain = Markov::Chain.new
+    chain.parse(File.read("data/war-and-peace.txt"))
+    chain.generate! # => "..."
 
 ## Requirements
+
+  - Ruby 2.3.0
 
 ## Install
 
     $ gem install markov