Merge "Fix doc build warnings"

doc/image-building.rst

@@ -96,8 +96,9 @@ repository named ``mykollarepo``::
 
     kolla-build -n mykollarepo --push
 
-To push images to a :ref:`local registry<deploy_a_registry>`, use
-``--registry`` flag::
+To push images to a `local registry
+<https://docs.openstack.org/kolla-ansible/latest/multinode.html#deploy-a-registry>`_,
+use ``--registry`` flag::
 
     kolla-build --registry 172.22.2.81:5000 --push
 
@@ -415,7 +416,8 @@ To make kolla-ansible pull images from a local registry, set
 ``"docker_registry"`` to ``"172.22.2.81:5000"`` in
 ``"/etc/kolla/globals.yml"``. Make sure Docker is allowed to pull images from
 insecure registry. See
-:ref:`Docker Insecure Registry Config <deploy_a_registry>`.
+`Docker Insecure Registry
+<https://docs.openstack.org/kolla-ansible/latest/multinode.html#deploy-a-registry>`_.
 
 Building behind a proxy
 -----------------------

setup.cfg

@@ -47,6 +47,7 @@ setup-hooks =
 all_files = 1
 build-dir = doc/build
 source-dir = doc
+warning-is-error = 1
 
 [build_releasenotes]
 all_files = 1

tox.ini

@@ -46,6 +46,7 @@ commands = {posargs}
 
 [testenv:docs]
 commands =
+  rm -rf doc/build
   doc8 doc
   python setup.py build_sphinx