Commit Graph

22 Commits (e0f7a522a3ef8b538e0b699dfa016237aff282b3)

Author SHA1 Message Date
Dag Wieers 3034709df0 Improve GitHub templates (#44455)
* Improve GitHub templates

The existing templates are basically a copy for each type of issue (bug,
feature, doc) whereas we can make the template more specific to the task
at hand.

This PR includes:
- More specific sections depending on the type of issue
- More concise and direct instructions (NO NEED FOR FRUSTRATION CAPS!)
- Single-line comments (no need to guide people to avoid wrong edits)
- Improved paste area
- Better headings/titles
- No 'Summary' title for PRs (so commit information is placed correctly)

This PR would require some improvements to Ansibot.

* Remove controversial Ansibot stuff

Make it easier to get the first batch merged.

* Restore ISSUE_TEMPLATE.md

* Incorporate reviewer suggestions

* Make OS / ENVIRONMENT doc-related

* Rephrase Ansibot-related message
6 years ago
Sam Doran 231c3586bd
Move summary to top for issue template (#40401) 7 years ago
Sviatoslav Sydorenko c30f46f7c6 Add note about bot to the issue template 7 years ago
John Barker 4e56dcd01a Update Issue & PR templates to make them clearer
Try and reduce people typing in the comments section
7 years ago
Brian Coca cd235e9eb0 BELOW THIS COMMENT 7 years ago
Brian Coca 70c0875dbc clarify input location 7 years ago
Rvgate 48005da645 There is no master branch in this project (#35773)
Since there is no master branch, best not to mention it in the issue
template to avoid confusion.
7 years ago
Dag Wieers 3db8b75f35
Remove slashes from instructions to avoid confusion 7 years ago
John R Barker 7654195716
Avoid people listing component in comment 7 years ago
Dag Wieers e76e8aed90
Fix closing tag for COMPONENT NAME, multiline changes 7 years ago
John R Barker 390a17f0eb
Update ISSUE_TEMPLATE.md 7 years ago
Toshio Kuratomi c82cf791dd Add a code-smell test for smart quotes and remove smart quotes from all files 7 years ago
Brian Coca 83ef5237cd added note about ansible-config to issue template 7 years ago
John R Barker 830ad2351f Ask for Network OS version info (#25958) 8 years ago
Dag Wieers 8a25b2477c Remove the hint to report module issue elsewhere. 8 years ago
Matt Clay 1da20c9716 Clean up issue templates. (#19011)
* Remove legacy GitHub templates.
* Remove references to module repos.
8 years ago
Dag Wieers 947877dcce 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
jctanner df81f1197f Add Component Name to the issue and pr templates (#17019) 8 years ago
Dag Wieers f9c4fdab40 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
Dag Wieers e4701b12ee One more improvement 9 years ago
Dag Wieers 2e9fc91844 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
Dag Wieers 1afa369eec Move the Github issue and pull-request templates to .github
In essence, most people do not need to use the templates directly,
getting them out of the way increases the signal-to-noise ratio of
the root directory. Direct people to what they are looking for.
9 years ago