Update the role documentation to match the new format. Each role project
should maintain the configuration variations for the role project
itself.
Change-Id: I73b061da40b08b327fc3445e073cbd8997920ccd
The 'docs' tox target executes the doc8 lint test which may result in
failures when testing documentation builds, but OpenStack-CI does not
execute that tox target.
In order to ensure that we catch all standard documentation syntax
errors and prevent them from merging, this patch includes the docs
target in the 'linters' chain of tests.
Fixes for any failures which result from executing this test are also
included in the patch.
Change-Id: I0f3d0585da4e9d946627bb78dc7314149e8dee9f
Utilizing RST includes to reduce duplication of documentation
effort. All contents of the Ansible defaults/main.yml are
now included in the documentation directly.
Change-Id: Ib5224208259bc50b80cff2613f487ecbe461719a