ansible/.github/ISSUE_TEMPLATE.md

<!---
Please do not report issues/requests related to Ansible modules here !!

Report them to the appropriate modules-core or modules-extras project:
  - https://github.com/ansible/ansible-modules-core/issues
  - https://github.com/ansible/ansible-modules-extras/issues

Also verify first that your issue/request is not already reported in GitHub
-->


##### ISSUE TYPE
<!--- Pick one below and delete the rest: -->
 - Bug Report
 - Feature Idea
 - Documentation Report

##### COMPONENT NAME
<!--- Name of the plugin/task/feature -->

##### ANSIBLE VERSION
<!--- Paste verbatim output from “ansible --version” between quotes below -->
```

```

##### CONFIGURATION
<!---
Mention any settings you have changed/added/removed in ansible.cfg
(or using the ANSIBLE_* environment variables).
-->

##### OS / ENVIRONMENT
<!---
Mention the OS you are running Ansible from, and the OS you are
managing, or say “N/A” for anything that is not platform-specific.
-->

##### SUMMARY
<!--- Explain the problem briefly -->

##### STEPS TO REPRODUCE
<!---
For bugs, show exactly how to reproduce the problem.
For new features, show how the feature would be used.
-->

<!--- Paste example playbooks or commands between quotes below -->
```

```

<!--- You can also paste gist.github.com links for larger files -->

##### EXPECTED RESULTS
<!--- What did you expect to happen when running the steps above? -->

##### ACTUAL RESULTS
<!--- What actually happened? If possible run with extra verbosity (-vvvv) -->

<!--- Paste verbatim command output between quotes below -->
```

```
Try to avoid module-related tickets in the core Ansible project (#17047) * Try to avoid module-related tickets in the core Ansible project Since most users still report module-related problems in the Ansible core GitHub project, I added a warning at the top of the template. Maybe it could help if the various projects would have more specific names ? - ansible/ansible -> ansible/main (or something even better ?) - ansible/ansible-modules-core -> ansible/modules-core - ansible/ansible-modules-extras -> ansible/modules-extras I am sure someone can come up with perfect names ;-) * Remove 'module' from the component options I would prefer to again note that modules should go elsewhere, but don't want to bloat the text too much. 8 years ago			`<!---`
			`Please do not report issues/requests related to Ansible modules here !!`

			`Report them to the appropriate modules-core or modules-extras project:`
			`- https://github.com/ansible/ansible-modules-core/issues`
			`- https://github.com/ansible/ansible-modules-extras/issues`

			`Also verify first that your issue/request is not already reported in GitHub`
			`-->`

Moving the github issue template file to this repo 10 years ago
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`##### ISSUE TYPE`
			`<!--- Pick one below and delete the rest: -->`
Edit the ISSUE_TEMPLATE The old template was effusive at the expense of making the text harder to read and easier to miss things in. This one is more direct, and easy to scan quickly. 9 years ago			`- Bug Report`
			`- Feature Idea`
			`- Documentation Report`
Moving the github issue template file to this repo 10 years ago
Add Component Name to the issue and pr templates (#17019) 8 years ago			`##### COMPONENT NAME`
Try to avoid module-related tickets in the core Ansible project (#17047) * Try to avoid module-related tickets in the core Ansible project Since most users still report module-related problems in the Ansible core GitHub project, I added a warning at the top of the template. Maybe it could help if the various projects would have more specific names ? - ansible/ansible -> ansible/main (or something even better ?) - ansible/ansible-modules-core -> ansible/modules-core - ansible/ansible-modules-extras -> ansible/modules-extras I am sure someone can come up with perfect names ;-) * Remove 'module' from the component options I would prefer to again note that modules should go elsewhere, but don't want to bloat the text too much. 8 years ago			`<!--- Name of the plugin/task/feature -->`
Moving the github issue template file to this repo 10 years ago
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`##### ANSIBLE VERSION`
Move comments out of code-blocks (#15961) In hindsight, I think it is better to have empty code-blocks then comment placeholders when people don't replace those sections. 9 years ago			`<!--- Paste verbatim output from “ansible --version” between quotes below -->`
Use triple-backticks for verbatim output It's easier than indenting by four spaces, as @willthames points out. 9 years ago			```
Move comments out of code-blocks (#15961) In hindsight, I think it is better to have empty code-blocks then comment placeholders when people don't replace those sections. 9 years ago
Use triple-backticks for verbatim output It's easier than indenting by four spaces, as @willthames points out. 9 years ago			```
Moving the github issue template file to this repo 10 years ago
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`##### CONFIGURATION`
Put the advice to the user as comments in the template Most issues include parts of the advice from the template, which adds noise to tickets. E.g. A lot of tickets include the text "Please pick one and delete the rest:" By adding the advice to the user as comments (<!--- comment -->) we achieve two important things: 1. The advice does not end up in the actual issue ticket or pull request 2. It is easier for the user to differentiate its own input and the original advice (And my help them to clean up the advice as well, which in fact is now no longer necessary) 9 years ago			`<!---`
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`Mention any settings you have changed/added/removed in ansible.cfg`
Edit the ISSUE_TEMPLATE The old template was effusive at the expense of making the text harder to read and easier to miss things in. This one is more direct, and easy to scan quickly. 9 years ago			`(or using the ANSIBLE_* environment variables).`
Put the advice to the user as comments in the template Most issues include parts of the advice from the template, which adds noise to tickets. E.g. A lot of tickets include the text "Please pick one and delete the rest:" By adding the advice to the user as comments (<!--- comment -->) we achieve two important things: 1. The advice does not end up in the actual issue ticket or pull request 2. It is easier for the user to differentiate its own input and the original advice (And my help them to clean up the advice as well, which in fact is now no longer necessary) 9 years ago			`-->`
Config might be important for issues. 10 years ago
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`##### OS / ENVIRONMENT`
Put the advice to the user as comments in the template Most issues include parts of the advice from the template, which adds noise to tickets. E.g. A lot of tickets include the text "Please pick one and delete the rest:" By adding the advice to the user as comments (<!--- comment -->) we achieve two important things: 1. The advice does not end up in the actual issue ticket or pull request 2. It is easier for the user to differentiate its own input and the original advice (And my help them to clean up the advice as well, which in fact is now no longer necessary) 9 years ago			`<!---`
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`Mention the OS you are running Ansible from, and the OS you are`
Put the advice to the user as comments in the template Most issues include parts of the advice from the template, which adds noise to tickets. E.g. A lot of tickets include the text "Please pick one and delete the rest:" By adding the advice to the user as comments (<!--- comment -->) we achieve two important things: 1. The advice does not end up in the actual issue ticket or pull request 2. It is easier for the user to differentiate its own input and the original advice (And my help them to clean up the advice as well, which in fact is now no longer necessary) 9 years ago			`managing, or say “N/A” for anything that is not platform-specific.`
			`-->`
Moving the github issue template file to this repo 10 years ago
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`##### SUMMARY`
One more improvement 9 years ago			`<!--- Explain the problem briefly -->`
Moving the github issue template file to this repo 10 years ago
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`##### STEPS TO REPRODUCE`
Put the advice to the user as comments in the template Most issues include parts of the advice from the template, which adds noise to tickets. E.g. A lot of tickets include the text "Please pick one and delete the rest:" By adding the advice to the user as comments (<!--- comment -->) we achieve two important things: 1. The advice does not end up in the actual issue ticket or pull request 2. It is easier for the user to differentiate its own input and the original advice (And my help them to clean up the advice as well, which in fact is now no longer necessary) 9 years ago			`<!---`
One more improvement 9 years ago			`For bugs, show exactly how to reproduce the problem.`
			`For new features, show how the feature would be used.`
Put the advice to the user as comments in the template Most issues include parts of the advice from the template, which adds noise to tickets. E.g. A lot of tickets include the text "Please pick one and delete the rest:" By adding the advice to the user as comments (<!--- comment -->) we achieve two important things: 1. The advice does not end up in the actual issue ticket or pull request 2. It is easier for the user to differentiate its own input and the original advice (And my help them to clean up the advice as well, which in fact is now no longer necessary) 9 years ago			`-->`
Edit the ISSUE_TEMPLATE The old template was effusive at the expense of making the text harder to read and easier to miss things in. This one is more direct, and easy to scan quickly. 9 years ago
Move comments out of code-blocks (#15961) In hindsight, I think it is better to have empty code-blocks then comment placeholders when people don't replace those sections. 9 years ago			`<!--- Paste example playbooks or commands between quotes below -->`
Use triple-backticks for verbatim output It's easier than indenting by four spaces, as @willthames points out. 9 years ago			```
Move comments out of code-blocks (#15961) In hindsight, I think it is better to have empty code-blocks then comment placeholders when people don't replace those sections. 9 years ago
Use triple-backticks for verbatim output It's easier than indenting by four spaces, as @willthames points out. 9 years ago			```

Put the advice to the user as comments in the template Most issues include parts of the advice from the template, which adds noise to tickets. E.g. A lot of tickets include the text "Please pick one and delete the rest:" By adding the advice to the user as comments (<!--- comment -->) we achieve two important things: 1. The advice does not end up in the actual issue ticket or pull request 2. It is easier for the user to differentiate its own input and the original advice (And my help them to clean up the advice as well, which in fact is now no longer necessary) 9 years ago			`<!--- You can also paste gist.github.com links for larger files -->`
Moving the github issue template file to this repo 10 years ago
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`##### EXPECTED RESULTS`
Put the advice to the user as comments in the template Most issues include parts of the advice from the template, which adds noise to tickets. E.g. A lot of tickets include the text "Please pick one and delete the rest:" By adding the advice to the user as comments (<!--- comment -->) we achieve two important things: 1. The advice does not end up in the actual issue ticket or pull request 2. It is easier for the user to differentiate its own input and the original advice (And my help them to clean up the advice as well, which in fact is now no longer necessary) 9 years ago			`<!--- What did you expect to happen when running the steps above? -->`
Moving the github issue template file to this repo 10 years ago
Various improvements to issue/pull-request templates - Instruct to verify if an issue/request already exists - Use uppercase for titles (easier to parse as titles) - Remove empty lines where it makes sense (instructions) - Ensure that commit-message appears directly under summary (pull-requests) 9 years ago			`##### ACTUAL RESULTS`
Move comments out of code-blocks (#15961) In hindsight, I think it is better to have empty code-blocks then comment placeholders when people don't replace those sections. 9 years ago			`<!--- What actually happened? If possible run with extra verbosity (-vvvv) -->`
Moving the github issue template file to this repo 10 years ago
Move comments out of code-blocks (#15961) In hindsight, I think it is better to have empty code-blocks then comment placeholders when people don't replace those sections. 9 years ago			`<!--- Paste verbatim command output between quotes below -->`
Use triple-backticks for verbatim output It's easier than indenting by four spaces, as @willthames points out. 9 years ago			```
Move comments out of code-blocks (#15961) In hindsight, I think it is better to have empty code-blocks then comment placeholders when people don't replace those sections. 9 years ago
Use triple-backticks for verbatim output It's easier than indenting by four spaces, as @willthames points out. 9 years ago			```