Fix niggles with the documentation

Now that we have an os-cloud-config-docs job, fix some warnings with
the documentation, which also makes it look nicer.

Change-Id: I2c7cad6dbd49a1868ea822df2cf0a8b845589059