2 Commits

Author SHA1 Message Date
Andreas Jaeger
38902dbba8 Fix check_jobs_documented linter
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
2020-04-10 19:07:25 +02:00
James E. Blair
4b3adfeea6 Organize documentation by subject area
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
2019-03-25 14:21:04 -07:00