Documentation edit: correct typos, and rephrase two paragraphs