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)
This commit is contained in:
Dag Wieers 2016-02-23 12:15:24 +01:00
parent 078ebb0dec
commit b432faa395
2 changed files with 24 additions and 16 deletions

View file

@ -1,6 +1,6 @@
##### Issue Type: ##### Issue Type:
Please pick one and delete the rest: <!--- Please pick one and delete the rest: -->
- Bug Report - Bug Report
- Feature Idea - Feature Idea
- Documentation Report - Documentation Report
@ -8,42 +8,48 @@ Please pick one and delete the rest:
##### Ansible Version: ##### Ansible Version:
``` ```
(Paste verbatim output from “ansible --version” here) <!--- Paste verbatim output from “ansible --version” here -->
``` ```
##### Ansible Configuration: ##### Ansible Configuration:
Please mention any settings you've changed/added/removed in ansible.cfg <!---
Please mention any settings you have changed/added/removed in ansible.cfg
(or using the ANSIBLE_* environment variables). (or using the ANSIBLE_* environment variables).
-->
##### Environment: ##### Environment:
<!---
Please mention the OS you are running Ansible from, and the OS you are Please mention the OS you are running Ansible from, and the OS you are
managing, or say “N/A” for anything that isn't platform-specific. managing, or say “N/A” for anything that is not platform-specific.
-->
##### Summary: ##### Summary:
Please explain the problem briefly. <!--- Please explain the problem briefly -->
##### Steps To Reproduce: ##### Steps To Reproduce:
<!---
For bugs, please show exactly how to reproduce the problem. For new For bugs, please show exactly how to reproduce the problem. For new
features, show how the feature would be used. features, show how the feature would be used.
-->
``` ```
(Paste example playbooks or commands here) <!--- Paste example playbooks or commands here -->
``` ```
You can also paste gist.github.com links for larger files. <!--- You can also paste gist.github.com links for larger files -->
##### Expected Results: ##### Expected Results:
What did you expect to happen when running the steps above? <!--- What did you expect to happen when running the steps above? -->
##### Actual Results: ##### Actual Results:
What actually happened? <!--- What actually happened? -->
``` ```
(Paste verbatim command output here) <!--- Paste verbatim command output here -->
``` ```

View file

@ -1,6 +1,6 @@
##### Issue Type: ##### Issue Type:
Please pick one and delete the rest: <!--- Please pick one and delete the rest: -->
- Feature Pull Request - Feature Pull Request
- New Module Pull Request - New Module Pull Request
- Bugfix Pull Request - Bugfix Pull Request
@ -9,19 +9,21 @@ Please pick one and delete the rest:
##### Ansible Version: ##### Ansible Version:
``` ```
(Paste verbatim output from “ansible --version” here) <!--- Paste verbatim output from “ansible --version” here -->
``` ```
##### Summary: ##### Summary:
Please describe the change and the reason for it. <!--- Please describe the change and the reason for it -->
(If you're fixing an existing issue, please include "Fixes #nnn" in your <!---
If you are fixing an existing issue, please include "Fixes #nnn" in your
commit message and your description; but you should still explain what commit message and your description; but you should still explain what
the change does.) the change does.
-->
##### Example output: ##### Example output:
``` ```
(Paste verbatim command output here if necessary) <!-- Paste verbatim command output here if necessary -->
``` ```