Docs: formatting and other corrections

Signed-off-by: John Thornton <jthornton@gnipsel.com>