If autoroles is used to document all roles - which is not the
case in this repo but in opendev/base-jobs, the linter would complain
about missing roles. Fix the linter to not complain.
This change is here to sync the two variants and avoid others that copy
it to run into the problem.
Change-Id: I25411157ff18858e4f4c121a6d3f0ba6ec793be0
This splits all of the current job and role documentation into
files by subject area so that jobs and roles are easier for users to
find.
This will require that any future new jobs or roles add a line to the
appropriate area of the documentation, since that can no longer be
done automatically. A linter check is added to ensure that every
job and role continue to be documented.
After this refactor, we can begin to enhance the documentation pages
so that they include narrative documentation and subsections.
Change-Id: Ia6f0e89b57e3cb0d7d1745206384c946506d7ea0