fixed typos, and made small improvements to the wording
Merge pull request #2766 from sbellem/doc-improvements

fixed typos, and made small improvements to the wording