diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md index 5b07d4cc..f1dc425c 100644 --- a/.github/ISSUE_TEMPLATE.md +++ b/.github/ISSUE_TEMPLATE.md @@ -5,13 +5,17 @@ Feel free to write an issue in your preferred format, however if in doubt, use the following checklist as a guide for what to include. * Have you tried the latest master version from Git? +* Do you have some idea of what the underlying problem may be? + https://mitogen.rtfd.io/en/stable/ansible.html#common-problems has + instructions to help figure out the likely cause and how to gather relevant + logs. * Mention your host and target OS and versions * Mention your host and target Python versions * If reporting a performance issue, mention the number of targets and a rough description of your workload (lots of copies, lots of tiny file edits, etc.) -* If reporting a crash or hang in Ansible, please rerun with -vvvv and include - the last 200 lines of output, along with a full copy of any traceback or - error text in the log. Beware "-vvvv" may include secret data! Edit as - necessary before posting. +* If reporting a crash or hang in Ansible, please rerun with -vvv and include + 200 lines of output around the point of the error, along with a full copy of + any traceback or error text in the log. Beware "-vvv" may include secret + data! Edit as necessary before posting. * If reporting any kind of problem with Ansible, please include the Ansible version along with output of "ansible-config dump --only-changed".