Doc edits prompted by Rachel's comments
(#581)