Add doc8 test and improve rst syntax

This will test all rst files inside the doc directory for style issues with
doc8 (an opinionated style checker for rst styles of documentation).

This will fix all syntax issues identified by doc8 and will improve
the syntax.

Change-Id: Id1b9563e07e77e306aef5a0767c98c27f87c5c0e

1 files changed, 3 insertions, 1 deletions

diff --git a/tox.ini b/tox.ini
index 3870dc915..aabd118ae 100644
--- a/tox.ini
+++ b/tox.ini
@@ -32,7 +32,9 @@ commands = bandit -r ansible/library dev docker kolla tests tools
 commands = {posargs}
 
 [testenv:docs]
-commands = python setup.py build_sphinx
+commands =
+  doc8 doc
+  python setup.py build_sphinx
 
 [testenv:setupenv]
 commands =