clarify documentation

Clean up some of the documentation text for readability.
Merge pull request #1 from bfallik/master

clarify documentation