DOC-1109: updated per tech review.
DOC-1109: typo fix.
DOC-1109: once more, with feeling.