diff --git a/requirements.txt b/requirements.txt
index 89351c3..0fb1d73 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,6 @@
 actdiag
 blockdiag
+doc8
 nwdiag
 oslosphinx
 pbr>=0.6,<1.0
diff --git a/tox.ini b/tox.ini
index b92724b..7ca8ce1 100644
--- a/tox.ini
+++ b/tox.ini
@@ -14,4 +14,6 @@ commands = python setup.py testr --slowest --testr-args='{posargs}'
 commands = {posargs}
 
 [testenv:docs]
-commands = python setup.py build_sphinx
+commands =
+  doc8 -e .rst specs/ doc/ README.rst
+  python setup.py build_sphinx