fix h1 formatting bug, add better overview

Change-Id: Ib9234fcd58242e0e7b5f6c43c4ee06848ab521e1
Reviewed-on: https://review.openstack.org/33688
Approved: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Tested-by: Jenkins