Make the doc look a bit better and give a better overview.

(styles mostly copied from Ceilometer docs)

Change-Id: Ie3eab4f579e0c16a09634faffb90e96a872d5d84
Merge "Make the doc look a bit better and give a better overview."