A member of the documentation community conducts a triage of open PRs and issues. The purpose is to minimize the number of stalled PRs and issues and help community members move forward.
There is no meeting. The triage lead reviews open PRs and issues, and leaves comments on GitHub or messages in the #theforeman-doc:matrix.org channel.
This is what the triage typically consists of:
A suggestion for how to run the triage:
-
Make this a time-boxed activity: As the triage lead, set an allotted time to conduct the triage, such as 15 minutes for PRs and 15 minutes for issues. (The triage lead is not expected to review all PRs and issues, and sticking to a reasonable time slot makes this task easier to fit into their schedule.)
-
Look at list of open PRs, excluding the ones in draft state, sorted by least recently updated: Pull requests · theforeman/foreman-documentation · GitHub
- Are there any blockers?
- If you spot a blocker, can you help resolve it? For example, you can notify a reviewer or leave a reminder for the author to continue working on the PR.
- If the chances of moving the PR forward are low for any reason, consider suggesting to switch the PR into draft state. This excludes the PR from the triage list.
- Look at list of open issues, sorted by least recently updated: GitHub · Where software is built
- Are there any blockers?
- If you spot a blocker, can you help resolve it? For example, you can identify someone to provide missing input or share the link in the Matrix channel to ask if anyone can assign the issue to themselves.
- If the chances of ever fixing the issue are low for any reason, consider closing the issue with an explanation.