Spec repos do not have code to unit test. The gate job definition for
the py27 and py35 jobs skip if there doc only changes, which is all we
will ever have in the specs repo. Therefore the one "test" we had will
never be run.
We were using this unit test as a check for formatting issues with the
rst files. This was done before doc8 was available. Now that we can use
doc8, we should just switch to running that as part of the pep8 jobs.
Also fixes all the errors caught by doc8 that were not caught by our
unit test check.
Change-Id: Ida20764edde3a07c89703d82b41958c96548b239
5016627f04