diff --git a/README.rst b/README.rst
index 6fd499374..d86721232 100644
--- a/README.rst
+++ b/README.rst
@@ -177,7 +177,7 @@ in a stand-alone fashion.
   changing the nginx configuration accordingly.
 
   * Bifrost playbooks can leverage and optionally install keystone.
-    See :ref:`keystone`.
+    See `doc/source/keystone.rst`.
 
 * Neutron is NOT installed. Ironic performs static IP injection via
   config-drive.
diff --git a/doc/source/howto.rst b/doc/source/howto.rst
index a27488df3..9b3ece21e 100644
--- a/doc/source/howto.rst
+++ b/doc/source/howto.rst
@@ -27,8 +27,8 @@ which should print an empty table if connection to Ironic works as expected.
 Enroll Hardware
 ===============
 
-The following requirements are installed during the `Installation`_ step
-above:
+The following requirements are installed during the install process
+as documented in the install documentation.
 
 - openstack-infra/shade library
 - openstack-infra/os-client-config
diff --git a/setup.cfg b/setup.cfg
index 8ce25516f..36e75bbe0 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -30,6 +30,7 @@ console_scripts =
 source-dir = doc/source
 build-dir = doc/build
 all_files = 1
+warning-is-error = 1
 
 [upload_sphinx]
 upload-dir = doc/build/html
diff --git a/troubleshooting.rst b/troubleshooting.rst
index 9880f96ce..195ea4e66 100644
--- a/troubleshooting.rst
+++ b/troubleshooting.rst
@@ -72,8 +72,8 @@ For documentation on diskimage-builder, See::
   http://docs.openstack.org/developer/diskimage-builder/.
 
 It should be noted that the steps for diskimage-builder installation and
-use to create an IPA image for Bifrost are the same as for ironic. See::
-  http://docs.openstack.org/developer/ironic/deploy/install-guide.html#image-requirements
+use to create an IPA image for Bifrost are the same as for ironic. See:
+http://docs.openstack.org/developer/ironic/deploy/install-guide.html#image-requirements
 
 This essentially boils down to the following steps: