1) Update doc links according to OpenStack document migration
2) Use https instead of http for docs links
Change-Id: I9b8473a439d15c741bc4d4809c4c4c122717f8a4
Make use of doc8 to verify all rst files which are not
autogenerated for errors and fail if there are any issues
found. The doc8 checks are now part of the tox 'docs'
environment and ran automatically. Checks can also be called
direcly via 'tox -e docs'.
Fix all issues found by doc8.
Closes-Bug: #1566765
Change-Id: I2b25247030a1aadcfe029c9e071ef17f2f72046b
Signed-off-by: Danny Al-Gaaf <danny.al-gaaf@bisect.de>
The information in the README file in the doc directory was very out of
date and the Makefile referenced in it doesn't appear to work any more.
Our preferred doc build method is to stay consistent with using tox -e docs,
so removing the legacy build information and providing better details for
doc development.
Change-Id: Ifd01b9cfc39fe99697a1669ecb5db6302359b662