Documentation fixes to make Sphinx happy

On this note, we have an issue with our current gate test for
documentation not properly catching these issues.  I'll be attempting to
address the issue in a future patch.

Change-Id: I7d0bea70ef98d1744200815ce12f1436729349e8
Signed-off-by: Paul Belanger <paul.belanger@polybeacon.com>
Reviewed-on: https://review.openstack.org/19889
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Approved: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins