Improve consistency of README

Better match description with code samples
Merge pull request #27 from agalloch/patch-1

Improve consistency of README