To manage new GitHub issues, maintainers perform issue triage on a regular basis and categorize the issues based on priority, type of issue, and other factors.
This process includes:
- Ensure the issue is relevant to the correct repository (i.e. build issues go to buildah repo, podman desktop issues go to Podman Desktop repo, etc) and transfer as needed.
- Categorize issues by type and assign its associated label (see below) and “traiged” label. If the issue is a bug and it is of high impact, please assign a high-impact label.
- Assign high-impact issues to either themselves or a core maintainer.
- If essential information is lacking, request it from the submitter and apply the 'needs-info' label.
- Once all the necessary information is gathered, the maintainer will assign the high-impact label if needed and removes the ‘needs-info’ label
- Check our issue closing policy and close the new issue if it matches the listed criteria.
While triaging, the maintainer has to look for the following information in the issue and ask the reporter for any missing information.
- Check what version of Podman, the distro, and any pertinent environmental notes the reporter is experiencing the problem on. This should come in the form of podman info as the issue template states.
- If the issue is distribution specific, then suggest in the comment that it should also be brought to the attention of the distribution and close the issue.
- If the reporter is not using the latest (or very near latest) version of Podman, the reporter should be asked to verify this still exists in main or at least in the latest release. The triager can also verify this.
- Check if there is a good reproducer that preferably reproduces on the latest Podman version
- Any other missing information that could help with debugging.
- Check for similar issues and act accordingly
- If the issue is related to Brew. Chocolatey or another package manager, suggest the reporter to use the latest binaries on the release page
- Check if the feature is already added to the newer Podman releases, if it is, add the appropriate suggestion and close the issue.
- Check if the feature is reasonable and is under the project’s scope
- Check if the feature is clear and ask for any missing information.
- An issue that impacts multiple users
- An issue that is encountered on each run of Podman
- An issue that breaks basic Podman functionality like
podman runorpodman build - A regression caused by new release
- network
- quadlet
- machine
- kube
- storage
- build
- windows
- macos
- documentation
- pasta
- remote
- compose
- regression