docs: Rework documentation style and consistency

This is a fixup commit amounting to the prior commits made on this
branch but incorporating the changes required after the `manual.pdf`
rework on #974.

Author: dybucc