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
Merge "Add doc8 to the py27 test running"