Just some general documentation maintenance

- fix typos
- edit for consistency
- remove some duplicate/unnecessary comments

cc @jcantrell