Edits from Alison's initial review

DOC-34
Merge pull request #2947 from edx/markhoeber/documentation/doc-34

Edits from Alison's initial review