diff --git a/doc/source/index.rst b/doc/source/index.rst
index 1be7eff..43ee57f 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -3,7 +3,7 @@
 ==============================================
 
 This is a client for the OpenStack Images API. There's :doc:`a Python
-API <library/api/index>` (the :mod:`glanceclient` module) and a
+API <reference/api/index>` (the :mod:`glanceclient` module) and a
 :doc:`command-line script <cli/glance>` (installed as
 :program:`glance`).
 
diff --git a/glanceclient/common/utils.py b/glanceclient/common/utils.py
index cc3387c..d194e65 100644
--- a/glanceclient/common/utils.py
+++ b/glanceclient/common/utils.py
@@ -311,7 +311,7 @@ def get_file_size(file_obj):
     """Analyze file-like object and attempt to determine its size.
 
     :param file_obj: file-like object.
-    :retval The file's size or None if it cannot be determined.
+    :retval: The file's size or None if it cannot be determined.
     """
     if (hasattr(file_obj, 'seek') and hasattr(file_obj, 'tell') and
             (six.PY2 or six.PY3 and file_obj.seekable())):
diff --git a/setup.cfg b/setup.cfg
index 8276c63..7699cab 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -36,6 +36,7 @@ console_scripts =
 [build_sphinx]
 builders = html,man
 all-files = 1
+warning-is-error = 1
 source-dir = doc/source
 build-dir = doc/build