Add doc8 to the py27 test running

To ensure the docs are style checked add in doc8 to the
py27 tox environment so that the docs will be checked.

This also adjusts the one issue that was found in one
of the rst files.

Change-Id: Iea38d4ac53d9c5255e0694a840c38b04530890ce

doc/source/tutorial/coordinator.rst

@@ -1,6 +1,6 @@
-=====================
+=======================
  Creating A Coordinator
-=====================
+=======================
 
 The principal object provided by tooz is the *coordinator*. It allows you to
 use various features, such as group membership, leader election or

tox.ini

@@ -16,12 +16,21 @@ deps = -r{toxinidir}/requirements.txt
        -r{toxinidir}/test-requirements.txt
 commands = {posargs}
 
+[testenv:py27]
+deps = {[testenv]deps}
+    doc8
+commands = bash -x {toxinidir}/setup-test-env.sh python setup.py testr --slowest --testr-args="{posargs}"
+    doc8 doc/source
+
 [testenv:cover]
 commands =
     bash -x {toxinidir}/setup-test-env.sh python setup.py testr --slowest --coverage --testr-args="{posargs}"
 
 [testenv:docs]
-commands = python setup.py build_sphinx
+deps = {[testenv]deps}
+    doc8
+commands = doc8 doc/source
+    python setup.py build_sphinx
 
 [testenv:pep8]
 deps = hacking>=0.9.2,<0.10