A variable reassignment in conf.py caused errors when we try to build
release versions of docs. Correct that by swapping the order of use
and assignment.
Change-Id: Ica90e9c0cc20aa590ad0177a0ceab72f4f4c6b5b
This modifies autoroles to raise a warning when it finds a role
without a README.rst file. This can be disabled with a config option
if you wish to build with warning-as-error but don't wish to document
roles.
Fix a typo in the readme for the zuul_role_paths
Add a test for the autoroles path detection by including a roles
directory under a subdir. Manually removing the README.rst file has
validated that the warning is triggered.
Change-Id: Ia64298e6e910d21eb6f3830dd8b42e40e3444fa8
This imports the current directives from Zuul itself, and adds
an example doc page that exercises them all so this repo is more
self-testing.
Also, use python3 by default to ensure we remain py3 compat.
Change-Id: Ie5b3cedd5e8dfaf0763d09a901fc9ba0e5b63683
Sphinx and pbr are run-time requirements of this package.
Remove dep on oslosphinx.
Tell pbr our package name.
Change-Id: Ia23cb2845b4d482888637728ac7712358e5e3629