a5136b73ad
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
455 B
455 B
Example README.rst
An example README.rst for a role
Role Variables
foo
This is a variable used by this role.
bar
This is a sub key.
items
This variable is a list.
baz
This is an item in a list.
This is an (Ansible) role (Sphinx) role: example
This is an (Ansible) role variable (Sphinx) role: example.items.baz