Implement doc8 checks for docs

In order to prepare for the move of detailed configuration
content from the install guide to the roles, doc8 checks
are being implemented in the roles to ensure that any new
content submitted is properly checked.

Change-Id: I9a70135f07c3faed957fd2438526d2059ac89594
Partially-Implements: blueprint osa-install-guide-overhaul
This commit is contained in:
Jesse Pretorius 2016-07-13 12:54:26 +01:00
parent d3087b9112
commit b5459cec5a
2 changed files with 8 additions and 1 deletions

View File

@ -4,4 +4,5 @@ flake8>=2.5.4,<2.6.0 # MIT
# this is required for the docs build jobs
sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.3 # BSD
oslosphinx>=2.5.0,!=3.4.0 # Apache-2.0
reno>=1.6.2 # Apache-2.0
doc8 # Apache-2.0
reno>=1.6.2 # Apache-2.0

View File

@ -32,9 +32,15 @@ setenv =
[testenv:docs]
commands=
bash -c "rm -rf doc/build"
doc8 doc
python setup.py build_sphinx
[doc8]
# Settings for doc8:
extensions = .rst
[testenv:releasenotes]
# NOTE(sdague): this target does not use constraints because
# upstream infra does not yet support it. Once that's fixed, we can