# Should we have issue templates? **URL:** \ **Category:** Forum Guide & Feedback\ **Tags:** feedback-wanted, forum-issue\ **Created:** [September 22, 2023, 9:50am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039 "2023-09-22T09:50:27Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![Kevinwincott](https://avatars.discourse-cdn.com/v4/letter/k/f08c70/32.png) [@Kevinwincott](https://forum.ansible.com/u/Kevinwincott)\ **Post date:** [September 22, 2023, 9:50am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/1 "2023-09-22T09:50:27Z")
**(Mod edit: this was originally a PM but we agreed to make it public for wider discussion)** Hi All, Didn’t get chance to speak to @gwmngilfen too much in Berlin (my fault) but one of the things that I found that made learning Ansible really hard was the lack of reliable help with questions, there are tons and tons of resources out there but a lot are outdated, and incorrect for the questions narrative, one I struggled with early on was down to something that worked in one version and not another (can’t recall what it was). Something that I think would help engage a lot more people would be a sort of quality guardian approach to answers, so that if a user asks a question they can be sure that they answer/approach thats suggested will work for them. I can appreciate how hard this can be in this sort of environment, both from a management and time management perspective to implement. It almost needs a “new user” section with a set of people that can either give specific answers, or verify that an answer is correct One thing that I implemented many years ago in a company was when a user asked for help for something they would have to fill in a s template post, with information that was likely to variable, like OS version, management agent etc so that when someone else came to answer the ticket they could give an answer that was applicable to the versions in use ---
**Author:** ![cybette](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/cybette/32/16_2.png) [@cybette](https://forum.ansible.com/u/cybette)\ **Post date:** [September 22, 2023, 10:12am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/2 "2023-09-22T10:12:29Z")
Great to have you at Ansible Community Day, @Kevinwincott ! The template approach sounds useful, we can certainly look into that. ---
**Author:** ![Kevinwincott](https://avatars.discourse-cdn.com/v4/letter/k/f08c70/32.png) [@Kevinwincott](https://forum.ansible.com/u/Kevinwincott)\ **Post date:** [September 22, 2023, 10:15am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/3 "2023-09-22T10:15:01Z")
great, happy to help in way I can, id like to get more involved in the ansible community, particularly in the speaking side ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [September 22, 2023, 10:26am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/4 "2023-09-22T10:26:05Z")
Templates are indeed possible, although in my experience with GitHub Issue templates they are frequently ignored. It’s definitely worth considering though. Is there any reason to keep this private? @Kevinwincott can I move this to #Forum Guide & Feedback ? ---
**Author:** ![Kevinwincott](https://avatars.discourse-cdn.com/v4/letter/k/f08c70/32.png) [@Kevinwincott](https://forum.ansible.com/u/Kevinwincott)\ **Post date:** [September 22, 2023, 10:30am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/5 "2023-09-22T10:30:38Z")
yes of course, when ive used templates in the past ive always told people to google GiGo, then fill in the template, seems to prompt less technical people to give complete answers… ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [September 25, 2023, 11:34am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/7 "2023-09-25T11:34:01Z")
---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [September 25, 2023, 11:44am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/8 "2023-09-25T11:44:27Z")
Looking back over this (and thanks to @Kevinwincott for letting me publish it) there seems to be two points here: 1. Can we use templates in #Get Help? 2. Can we verify solutions? For 1 the answer is _sort of_. We _can_ have a template that is inserted into each post - _however_ you can only have _one_. Given the sheer breadth of information that might be relevant to different projects (e.g. compare an issue with a file-in-line playbook to a webhook error on AWX…) it seems difficult to design a useful template for all possible usecases that isn’t just really vague. However, I can see some scope for a very simple thing such as a reminder to include relevant information, etc. Thoughts here? For 2, the answer is no, at least in the way I think you mean. This is the place for the community to support **itself** , and all are welcome to give input - indeed, that is the only way this can scale to the number of users Ansible has (as a FOSS project we don’t actually know that number, but my conservative estimate is “low millions”). Having a dedicated team will not scale, I don’t think. Now, that said, the forum _itself_ provides tools for this - over time. more people will hit that “Solved” button, and the people who are good at solving things will get recognised for it (check [these](http://forum.ansible.com/badges/103/solved) [badges](http://forum.ansible.com/badges/104/guidance-counsellor) [out](http://forum.ansible.com/badges/105/know-it-all). We can look to giving such people a prominent title (Support Expert, perhaps?) so that people can have confidence in their answers. Does that help address your concern? ---
**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\ **Post date:** [September 25, 2023, 4:04pm UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/9 "2023-09-25T16:04:43Z")
I like the idea of a basic template in the help section. I think even a few vague hints can help. As for a way to help new folks - I wonder if there’s a way we can help new ansible people help other…new ansible people? I tried this on another project and with a couple of mentors in the space, it really worked well. Tho it was for something far less technical than Ansible… Or maybe we ask for a blog post or How To’ post here that is specifically directed to new Ansible users and gives them links to a curated list of resources that the community feels are accurate and helpful for onboarding new people into Ansible? ---
**Author:** ![Kevinwincott](https://avatars.discourse-cdn.com/v4/letter/k/f08c70/32.png) [@Kevinwincott](https://forum.ansible.com/u/Kevinwincott)\ **Post date:** [September 25, 2023, 4:08pm UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/10 "2023-09-25T16:08:07Z")
@gwmngilfen thats where I was heading in an indirect way ☹ a method so that if a user asks a question and gets 10 different replies, the ones that come from people who are verified/trusted, their answer can be thought of as true. ---
**Author:** ![ads](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/ads/32/747_2.png) [@ads](https://forum.ansible.com/u/ads)\ **Post date:** [September 25, 2023, 9:49pm UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/11 "2023-09-25T21:49:22Z")
> [@gwmngilfen](#): > > although in my experience with GitHub Issue templates they are frequently ignored They are ignored at times, mostly by inexperienced users. The follow-up - possibly automated - can be to ask the user to fill in the template, assign the issue to the user and set a label “waiting for user input” or similar. ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [September 26, 2023, 8:16am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/12 "2023-09-26T08:16:06Z")
> [@ads](#): > > The follow-up - possibly automated - can be to ask the user to fill in the template, assign the issue to the user and set a label “waiting for user input” or similar. Good idea. Automation is possible, of course, but not natively - I think we’d have to write a bot or something. However we do have template replies available to staff, so we can make it easy to reply manually. ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [September 26, 2023, 8:57am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/13 "2023-09-26T08:57:12Z")
There’s one other thing we can do, although I’ll have to test how it interacts with a “normal” template… Using [these docs](https://meta.discourse.org/t/how-to-create-a-new-topic-link-with-pre-filled-information/28074) it is possible to create a deeplink for creating a new issue with various fields filled in. That includes possibly filling in the body, for example: ```auto http://forum.ansible.com/new-topic?body=my%20template%20here&category=help&tags=awx ``` Now we can’t easily make a whole bunch of these links _here_, but we _can_ encourage the various projects to put this kind of thing in their docs (with a template they can then control, asking for the information they need). Not everyone will get here from there, but again it may help. ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [September 27, 2023, 9:17am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/14 "2023-09-27T09:17:05Z")
OK, so I think we need to get this going. How does the following template sound? * * * **Please replace this text with a description of your issue**. You should: - Include the version(s) of the relevant software tools, libraries, collections etc - Include relavant logs from the issue - Use backticks (```) to help format your logs and code (easy-to-read posts are easier to answer too!), like this: ```auto - my code! ``` - Set at least one tag (the experts follow the tags, so the right people will find you if you tag) * * * I’m deliberately _not_ mentioning the over-use of Groups, and emphasising tag use instead - drawing attention to the possibility of mentioning a Group might actually _increase_ the use of it. I think we should use [replies like this](http://forum.ansible.com/t/cant-run-ssh-against-an-network-device-extreme-slx-switch/1137/2) when we see people abusing the feature 🙂 How does that sound? ---
**Author:** ![Kevinwincott](https://avatars.discourse-cdn.com/v4/letter/k/f08c70/32.png) [@Kevinwincott](https://forum.ansible.com/u/Kevinwincott)\ **Post date:** [September 27, 2023, 9:48am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/15 "2023-09-27T09:48:37Z")
Sounds good to me, is OS a consideration too though? ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [September 27, 2023, 10:06am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/16 "2023-09-27T10:06:30Z")
Sadly I think that’s a property of “relevant versions” because much of the time it won’t be - it might apply if, say, managing network config or SELinux, but not if interacting with switches or writing an API playbook. ---
**Author:** ![ads](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/ads/32/747_2.png) [@ads](https://forum.ansible.com/u/ads)\ **Post date:** [September 27, 2023, 10:58am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/17 "2023-09-27T10:58:18Z")
At this point, how about start using the template, and see how it is used? The actual questions asked in the template can be slightly adjusted if it turns out that something is missing, or people misinterpret it, or add too many unnecessary details. ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [September 27, 2023, 11:06am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/18 "2023-09-27T11:06:27Z")
Heh, I’ve been doing community too long, always looking for consensus first 🙂 I’ve deployed a template, keep the feedback coming here if we need to tweak it ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [November 22, 2023, 9:50am UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/19 "2023-11-22T09:50:34Z")
So @utoddl, @briantist @jrglynn2 and I were discussing this a bit in Matrix yesterday. If I recall correctly, there’s interest in knowing what (if any) research a user has already done, especially if that (a) helps them to find the docs, or (b) helps us to understand where the docs could be better. We’re thinking it might make sense to add something similar to [How do I ask a good question? - Help Center - Stack Overflow](https://stackoverflow.com/help/how-to-ask) somewhere (possibly in #Guides, FAQs & Howtos?) and then add a short header to the template that encourages people to detail what they’ve already looked at/tried. Any thoughts folks? Assuming I don’t hear problems, I’ll update the template next week… ---
**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\ **Post date:** [November 27, 2023, 10:01pm UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/20 "2023-11-27T22:01:03Z")
I like this idea. It helps users to remember to add more detail to their topics and that will help them get better answers. ---
**Author:** ![jbericat](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/jbericat/32/627_2.png) [@jbericat](https://forum.ansible.com/u/jbericat)\ **Post date:** [December 19, 2023, 12:36pm UTC](https://forum.ansible.com/t/should-we-have-issue-templates/1039/21 "2023-12-19T12:36:30Z")
Hey Greg! I just discovered this thread yesterday 🫣 > [@gwmngilfen](#): > > OK, so I think we need to get this going. How does the following template sound? Looks great to me… +1!