Additional documentation tweaks.

I've put some feedback in with a few quick edits here. Also filed #30, #31, and #32 as inspirations from reading this through.