diff --git a/setup.cfg b/setup.cfg
index 04bb29f759..c9813700d1 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -49,7 +49,8 @@ oslo.config.opts =
 
 [build_sphinx]
 all-files = 1
-warning-is-error = 1
+# warning can be generated by using GENERATE_TEMPEST_PLUGIN_LIST='False'
+warning-is-error = 0
 build-dir = doc/build
 source-dir = doc/source
 
diff --git a/tox.ini b/tox.ini
index 5644641fd0..910317549b 100644
--- a/tox.ini
+++ b/tox.ini
@@ -146,7 +146,7 @@ deps =
   -r{toxinidir}/doc/requirements.txt
 commands =
   rm -rf doc/build
-  sphinx-build -b html doc/source doc/build/html
+  sphinx-build -W -b html doc/source doc/build/html
 whitelist_externals = rm
 
 [testenv:pep8]