diff --git a/doc/source/index.rst b/doc/source/index.rst
index 717c9653..ded4c8b9 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -1,7 +1,8 @@
 Welcome to python-zunclient's documentation!
-==============================================
+============================================
 
-Contents:
+Contents
+--------
 
 .. toctree::
    :maxdepth: 2
@@ -11,7 +12,7 @@ Contents:
    contributor/index
 
 Indices and tables
-==================
+------------------
 
 * :ref:`genindex`
 * :ref:`modindex`
diff --git a/doc/source/install/index.rst b/doc/source/install/index.rst
index 73a8dcbd..cf9cf5f6 100644
--- a/doc/source/install/index.rst
+++ b/doc/source/install/index.rst
@@ -1,3 +1,4 @@
+==================
 Installation Guide
 ==================
 
diff --git a/doc/source/readme.rst b/doc/source/readme.rst
index a6210d3d..5c280588 100644
--- a/doc/source/readme.rst
+++ b/doc/source/readme.rst
@@ -1 +1,5 @@
+============
+Introduction
+============
+
 .. include:: ../../README.rst
diff --git a/test-requirements.txt b/test-requirements.txt
index 86bb0aea..97eec517 100644
--- a/test-requirements.txt
+++ b/test-requirements.txt
@@ -16,5 +16,3 @@ testresources>=2.0.0 # Apache-2.0/BSD
 testrepository>=0.0.18 # Apache-2.0/BSD
 testscenarios>=0.4 # Apache-2.0/BSD
 testtools>=2.2.0 # MIT
-
-# releasenotes
diff --git a/tox.ini b/tox.ini
index 86cba1c5..3f253cdd 100644
--- a/tox.ini
+++ b/tox.ini
@@ -46,7 +46,7 @@ deps =
   -r{toxinidir}/requirements.txt
   -r{toxinidir}/doc/requirements.txt
 commands =
-  sphinx-build -b html doc/source doc/build/html
+  sphinx-build -W -b html doc/source doc/build/html
 
 [testenv:pep8]
 commands =