Documentation fixes

some grammar and clarifications for the docs.
added this last sentence for clarification, please verify it is accurate.