formatting update and minor edits

formatting was updated to include one sentence per line, rather than
line wrapping. this aligns with how a lot of our newer docs work, and
tends to make interpreting diffs easier.

Co-authored-by: Colin Wood <[email protected]>