This requires fixing a number of docstring so they are valid rST. We add
the '--keep-going' flag to our Sphinx calls so we don't stop on the very
first failure.
Change-Id: Ia195fbc3be2e840e2afe1429b2bc2654bd1d5385
Co-authored-by: Stephen Finucane <stephenfin@redhat.com>