Fix rst errors so that html docs are complete
Fix rst errors so that html docs are complete

rst table format errors don't break the gate job
but do cause sections of the documents to go missing
from the html output.

Change-Id: Ic8c9953c93d03dcdafd8f47b271d276c7b356dc3

redbo/swift,revoer/keystone-8.0.0,tipabu/swift,hurricanerix/swift,rackerlabs/swift,williamthegrey/swift,revoer/keystone-8.0.0,larsbutler/swift,matthewoliver/swift,matthewoliver/swift,smerritt/swift,aerwin3/swift,rackerlabs/swift,psachin/swift,hurricanerix/swift,larsbutler/swift,aerwin3/swift,clayg/swift,tipabu/swift,levythu/swift,openstack/swift,hurricanerix/swift,swiftstack/swift,matthewoliver/swift,openstack/swift,clayg/swift,notmyname/swift,williamthegrey/swift,openstack/swift,psachin/swift,clayg/swift,notmyname/swift,clayg/swift,hurricanerix/swift,swiftstack/swift,tipabu/swift,prashanthpai/swift,nadeemsyed/swift,prashanthpai/swift,smerritt/swift,redbo/swift,smerritt/swift,matthewoliver/swift,notmyname/swift,notmyname/swift,tipabu/swift,nadeemsyed/swift,openstack/swift,smerritt/swift,psachin/swift,levythu/swift,swiftstack/swift,psachin/swift,nadeemsyed/swift,nadeemsyed/swift