grammar fix
improvements to validation section
Merge pull request #39 from tremby/documentation-patches

Documentation patches