doc: Fixes to normalize header hierarchy. Tweaked IA slightly.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>