Documentation fixes

some grammar and clarifications for the docs.
Makes sense  to me. 👍