Slightly more descriptive docs
Markup fix.
Merge pull request #2 from alex/patch-1

Slight cleanup to teh docs