Documentation fixes

some grammar and clarifications for the docs.
Will you update the PR (recommended) or do you want me to update (not recommended)? :D