Start running the doc8 RST linter in the pep8 job. This
will catch obvious errors like line too long, etc. Tried
to fix most of the errors (there were a lot!), but added
some ignore directives so we can address some files later.
Did have to move a couple of files around as a double
include was causing some issues, but content is unchanged.
Change-Id: I336a9ee7729045da095be22ea0f58ee596967174
7d139a013b