openstack/openstack-ansible-os_horizon
Code Issues Proposed changes

Implement doc8 checks for docs

Browse Source 
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: I71feb1f32e3233693ada8f29c356f3a219c51934
Partially-Implements: blueprint osa-install-guide-overhaul
This commit is contained in:
Jesse Pretorius 2016-07-13 12:55:58 +01:00
parent 87b7057aab
commit ad77b184f7
2 changed files with 8 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
test-requirements.txt
View File

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

6
tox.ini
View File

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