Documentation copy-editing, part 1

<clippy>It looks like you're trying to write documentation. Would you like some help?</clippy>

This is a first-pass effort.