cosmetic changes to the documentation

(more to come)
That's my inclination as well.

I'd let @djmitche to say something as well :smile: