Enable warning-is-error for doc builds

Some of the documentation linking is broken, and will need
to be fixed as the documentation is revamped for the doc
migration.

Change-Id: I23a5f8a7c0cc7b0ce19052a2383e20b96e195996

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.

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
+The following requirements are installed during the install process
-above:
+as documented in the install documentation.
 
 - openstack-infra/shade library
 - openstack-infra/os-client-config

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

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::
+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
+http://docs.openstack.org/developer/ironic/deploy/install-guide.html#image-requirements
 
 This essentially boils down to the following steps: