Documentation fixes

some grammar and clarifications for the docs.