GitHub Community
Feedback Wanted: Issue Forms beta and Issue Templates #63402
Replies: 69 comments 53 replies
-
|
Hello, I'm very happy that GitHub plans to improve issue forms. One main missing element is a preview to render and validate syntax when you are creating a form 1 2. Some input field types can be really useful:
Proposalbody:
- type: url
# ...body:
- type: tags
# ...body:
- type: file
# ...And custom validation (ex: regex) can be a good thing 5. Proposalbody:
- type: input
# ...
validations:
regexp: '[a-z]+'
# ...Some textarea can contain large content (ex: logs, code examples, ...), and being able to wrap them into Proposalbody:
- type: textarea
# ...
attributes:
label: A text area
placeholder: "Foo"
render: yml
details: true
# ...A very important element for me is conditional sections: being able to show/hide a form item based on a previous choice 7 8. Proposal - type: dropdown
id: section1
attributes:
# ...
options:
- A
- B
- C
- D
# ...
- type: checkboxes
id: section2
attributes:
options:
- label: Foo
id: item1
# ...
- type: input
depend-on:
id: section1
values:
- B
- D
attributes:
description: Bar
# ...
- type: input
depend-on:
id: section2.item1
values:
- true
attributes:
description: Foo
# ...In the same scope, a user-editable "other" field in dropdown can simplify the use of form 9. Proposal - type: dropdown
attributes:
# ...
others: true
options:
- A
- B
- C
- D
# ...Also being able to add details/descriptions to dropdown items can help users to understand the items. Proposal - type: dropdown
attributes:
# ...
options:
- value: A
description: This is the value A
- value: B
description: This is the value B
- value: C
description: This is the value C
- value: D
description: This is the value D
# ...The forms are very useful for issues, but they can also be really useful for pull requests 10. Bonus: gets issue form data via API to facilitate automation 11. Not sure if you expect this kind of feedback. Footnotes |
Beta Was this translation helpful? Give feedback.
-
|
It's been a year since this topic was started, can we have some feedback from the GitHub team? |
Beta Was this translation helpful? Give feedback.
-
|
😔 |
Beta Was this translation helpful? Give feedback.
-
|
Definitely some kind of rich web UI (WYSIWYG) to create/edit/preview[1] issue forms would be immensely useful. Similar to setting up issue templates, there could be an option to set up issue forms in a visual manner. Like, click "Add" and pick the control from a drop down list (e.g. "Text Area"); drag the controls to reorder, and have all the configurable options to the side (description, placeholder, value). Sort of like a form designer (MS Access, Visual Basic) which saves a perfect YAML! Nothing's wrong with the current documentation on the side (which I just discovered if I use the web UI, did not know that! I admit I haven't used this feature much). Being quite visual and eager to see what the user interacts with (and test input/output), the current YAML approach seems a little daunting to set up for many repositories, so the issue template wins for now. It could open doors to this suggestion whereby having a design view would make it easier to visualise logic for something like conditional fields. +1 for a URL and file ("drag and drop here!") inputs. |
Beta Was this translation helpful? Give feedback.
-
|
About the UI, I found a tool created by @geromegrignon that can be used as POC. |
Beta Was this translation helpful? Give feedback.
-
|
Hello, thanks for the mention. |
Beta Was this translation helpful? Give feedback.
-
|
It doesn't seem like the Edit: Also, it doesn't seem like the issue with |
Beta Was this translation helpful? Give feedback.
-
|
Let me look into this and I'll get back to you as soon as I can! |
Beta Was this translation helpful? Give feedback.
-
|
Thanks for the happy improvements on GitHub Issues and Projects! As indicated in this article, I would like to use the new configuration of the issue template that sets a project as default, but I can't do this with the configuration below. For example, our project's project URL is below.
Then I set the Can you tell me some correct examples? |
Beta Was this translation helpful? Give feedback.
-
|
I think that is not the right place to ask this kind of question, I recommend opening a dedicated topic. |
Beta Was this translation helpful? Give feedback.
-
|
Here is a working example, you can create issues and the project is public: https://github.com/kerhub/issue-forms-playground |
Beta Was this translation helpful? Give feedback.
-
|
@ldez Thanks for your advice. |
Beta Was this translation helpful? Give feedback.
-
|
@geromegrignon Thanks for your example! My trouble is solved by it. I noticed that my template created from "Set up templates" on the settings page is made as a ".md". I suspected the difference in file formats, so I converted to ".yml" and reconfigured it, then it worked! Thank you so much! |
Beta Was this translation helpful? Give feedback.
-
|
It'd be great if not only can you set the default project, but also other fields such as status and values for custom fields. |
Beta Was this translation helpful? Give feedback.
-
|
My expectation was that if I create inputs in the issue template, I would then be able to access these inputs as fields in the Project. Right now I am not sure at all where the information collected through the issue form goes...or how I can access it. |
Beta Was this translation helpful? Give feedback.
-
|
Hi @gotom22, I don't know how you want to use it but here is a use case grabbing form value in a GitHub action to update the project: geromegrignon/angular-hub@24c1040 |
Beta Was this translation helpful? Give feedback.
-
|
@geromegrignon thanks! Good to know, I keep that in mind. In the meantime will probably go with an off-the-shelf solution, i.e. Notion or similar. |
Beta Was this translation helpful? Give feedback.
-
|
Adding my vote here to be able to add "status" assignments to the issue template |
Beta Was this translation helpful? Give feedback.
-
|
Yes, mapping the form fields to custom fields is sorely needed! |
Beta Was this translation helpful? Give feedback.
-
|
Hello, Thanks for the improvements to the issue forms ! As I have been using the forms in a private repo, there is a functionality which would be really useful : the ability to modify some issues metadata dynamically from the form. In particular, modifying labels and affected milestones from a checkbox or a dropdown would help my team tremendously. Something which may (roughly) look like this :
Even though you can set the labels in the sidebar, it can be useful to set them in distinct form sections. For instance, I could have a dropdown dedicated to components labels and a dropdown dedicated to priority (setting labels like P1, P2, P3, etc). It is faster to navigate the dropdown list than searching through the labels manually. EDIT : I also saw this proposal to give access to tags within the forms, this would also be a very practical field to have access to. |
Beta Was this translation helpful? Give feedback.
-
|
Thank you for the issue forms feature, it is really great so far! The most important things I'm missing right now are:
I elaborated on the first point already in a comment on the linked discussion. As for the second point, here are some details. I maintain a bunch of libraries, and lots of them use the same issue forms to report bugs, suggest features or doc improvements, etc. Most of them only differ in the repo name that is mentioned in some field labels or descriptions. I would love it if I could define an issue form template with inputs (like a GitHub action) in some repo, and then reference this issue form template from for other repositories in their For example, I could have an issue form template like this in some repo called
inputs:
repo_name:
required: true
template:
name: Bug report
description: File a bug report
labels: ["bug"]
body:
- type: markdown
attributes:
value: Thanks for taking the time to fill out this bug report!
- type: input
id: version
attributes:
label: Version of {{ inputs.repo_name }}
description: In which version of {{ inputs.repo_name }} did you experience the issue?
validations:
required: true
- type: textarea
id: what-happened
attributes:
label: What happened?
placeholder: Incorrect behaviour, error message, stacktrace...
description: Please describe what you see and what you expected to happen instead
validations:
required: trueAnd then from all repositories that want to use it, something like this (syntax borrowed from GitHub Actions):
blank_issues_enabled: true
forms:
- uses: joffrey-bion/my-templates/bug_report_template.yml@v3
with:
repo_name: this-repo
contact_links:
- name: Ask a question
about: For general usage questions, please use GitHub Discussions
url: https://github.com/joffrey-bion/krossbow/discussions |
Beta Was this translation helpful? Give feedback.
-
Does the new |
Beta Was this translation helpful? Give feedback.
-
|
It works as expected on my side with a private project. |
Beta Was this translation helpful? Give feedback.
-
|
This is the template in question, there's nothing particularly novel about it AFAIK, and hasn't changed in a while. I was expecting to be able to just drop in the new |
Beta Was this translation helpful? Give feedback.
-
|
FYI, GitHub support has confirmed to me that this feature does not work with private projects and public issue templates. If the project is private, the user creating the issue with the template must have |
Beta Was this translation helpful? Give feedback.
-
|
I'm using the same YAML in 2 different repos. The form displays properly in one repo, but no form displays (but some of the attributes on the right do). Here is the code: Here is the preview, showing the form: And when I use the template from Issues > New Issues > YAML Form Templates > Get Started Using the template does populate the metadata, but does not display the form. The same code in any other repo does display the form. What is happening? |
Beta Was this translation helpful? Give feedback.
-
|
SOLVED. In the problem repository the template filename contained an emoji. I removed the emoji and the form presents properly. You can still use emojis in the template content, just not the actual filename. |
Beta Was this translation helpful? Give feedback.
-
|
when I'm creating an issue in GitHub Projects, would be great if I could use a form template from the repository the issue is created in instead of having to click into the repository to add an issue from there. |
Beta Was this translation helpful? Give feedback.
-
|
Agreed. I would love it if there was an option to attach issue templates and issues to a primary project while still being able to assign issues created there to multiple projects. |
Beta Was this translation helpful? Give feedback.
-
|
The issue forms are working much better for us than the issue templates! It's great to be able to provide instructional text to folks without having to use HTML comments.
Overall I'm happy with the experience. While a visual form builder would be nice, I don't have a problem using the yml directly. I just run my file through a yml validator. The GitHub plugin for VS Code that can do validation on GitHub Actions is pretty useful, and maybe it can be enhanced to validate issue forms as well? |
Beta Was this translation helpful? Give feedback.
-
|
Started using this recently and so far it's been a very smooth workflow, the only things I'd like to see in the near future are:
|
Beta Was this translation helpful? Give feedback.
-
|
I just found out about issue forms this week and have been learning and experimenting with the added features for our repositories! Here is my feedback so far: 1. Form validation accessThe validations keys for each of the existing input field types (
PLEASE enable this feature for private repositories too! Limiting the option to set a field as required for only public repositories seems counter intuitive to many of us. Private repositories need form validation just as much as a public repository would. 2. Post-commit error messagesTrying to get past all the errors was tedious once I was past the more helpful Body[i]: required key type is missing error messages because I had no line, column or character references. Getting a Checkboxes must have unique labels error when I have many to check and the body:
- type: checkboxes
id: operating-systems
attributes:
label: Which operating systems have you used? # <-- field label
description: You may select more than one.
options:
- label: macOS # <-- options label
- label: Windows
- label: Linux
validations:
required: true # <--- good feature for public and private repositories3. Feature request: Table/Matrix input typeI work in consumer electronics testing and we frequently have multiple physical products to record test results and issues for at the same time. Single line Something like this:
As the documentation and features evolve, please consider these improvements! Thank you for the awesome new way to template! |
Beta Was this translation helpful? Give feedback.
-
|
It'd be nice to have this for |
Beta Was this translation helpful? Give feedback.
-
|
+1 on making the required field available for private repositories. I just spent more time than I should've trying to figure out why it wasn't working before I read that detail in the docs. |
Beta Was this translation helpful? Give feedback.
-
|
Any progress on validations on private/internal repositories? |
Beta Was this translation helpful? Give feedback.
-
|
**searchbody:
|
Beta Was this translation helpful? Give feedback.
-
|
Bug: the |
Beta Was this translation helpful? Give feedback.
-
|
I've implemented issue forms for two projects so far. The biggest ask that I have (other than a way to visually preview the yaml on GitHub and ensure it validates / a visual issue form creator) would be more control over who can see certain forms and their items. Being able to restrict forms and fields to org members would be quite helpful! In leu of this being implemented, users have come up with hacky honor-based systems of restricting who can open issues which are lovely but not exactly the best user experience for all involved. ;) |
Beta Was this translation helpful? Give feedback.
-
|
How can the form templates be used in PRs? Documentation doesn't mention that. |
Beta Was this translation helpful? Give feedback.
-
|
Beta Was this translation helpful? Give feedback.
-
|
Thanks. When will they be supported? The concept of issue and PR templates is the same, PRs being even more important, yet they lack the important feature. |
Beta Was this translation helpful? Give feedback.
-
|
Love issue templates but would love them even more if there was an option to make the |
Beta Was this translation helpful? Give feedback.
-
|
Similar requests. Trying to generate some love for rendering |
Beta Was this translation helpful? Give feedback.
-
|
Nice, thanks for compiling that list! |
Beta Was this translation helpful? Give feedback.
-
|
+1; I run an open-source project with >30k users, and I would like to add a message to the bottom of every issue submitted instructing readers how to vote for an issue to be fixed. Many of my users are non-technical/not GitHub natives and don't know about emoji reactions, so it's important to have this extra text. As a workaround, I've found that it's possible to add a required checkbox that has the text you want to include, but this isn't a good user experience because it forces every user to tick the box rather than just including the text I want in the issue. Here's an example: - type: checkboxes
id: voting
attributes:
label: Voting
description: Please check the box below so GitHub will tell everyone how to vote for your issue—sorry, I know it's an unnecessary step, but that's the only way GitHub will allow me to include this message in the issue itself.
options:
- label: |
<em>Readers: If you are also experiencing this problem, please vote for it by giving the ORIGINAL POST a thumbs-up using the :smiley: button. You are welcome to leave comments and discuss the issue if you have more details to add, but "Me too!" comments are not counted by the voting system.</em>
required: true
validations:
required: true(And yes, I've already voted for this feature request everywhere I've found it, just hoping to push for this a little more.) |
Beta Was this translation helpful? Give feedback.
-
|
This is something I'm encountering now as part of OpenTelemetry. We want to add a sub-heading to all issues, instructing end-users to vote on issues, or leave comments, but it's hard with issue templates. |
Beta Was this translation helpful? Give feedback.
-
|
loving issue-forms as well, but I would like to be able to disable the markdown renderer for The string that users fill into our (this currently does not validate) |
Beta Was this translation helpful? Give feedback.
-
|
I would enjoy having a date input field type so that can be filled in in the expected format (YYYY-MM-DD for example) |
Beta Was this translation helpful? Give feedback.
-
|
Love issue forms! I'm using them in an org context and want to have the ability for forms to create issues in specific repositories, i.e. in the nflverse project it would be great to have an org level form chooser where data-specific issues are opened in nflverse/nflverse-data, R issues opened in nflverse/nflreadr, python issues in nflverse/nfldatapy etc. |
Beta Was this translation helpful? Give feedback.
-
|
Love the template and flexibility, Would love the possibility of the submitted issue rendering based on the template used for creation with all markdown and fields layout with readonly value. An amazing addition would be to allow us the option to edit the submitted issue using the existing template. This will enhance the UX of issues and make it more coherent and fleshed out when viewed after submission as it was intended on submission. |
Beta Was this translation helpful? Give feedback.
-
|
What is the rationale for not allowing |
Beta Was this translation helpful? Give feedback.
-
|
Not sure if this is the right thread to post this, but there's a bug which was introduced with the addition of the new GitHub issues beta. We have set up issue forms for a long time now, but after applying to the new GitHub issues beta and receiving access, the We have textarea inputs in our various issue forms for users to paste debug log. The textarea's I would appreciate if someone from the GitHub team(s) responsible for issue forms could have a look at this. |
Beta Was this translation helpful? Give feedback.
-
|
We also found this bug when using |
Beta Was this translation helpful? Give feedback.
-
|
When will regex validation support be added for text fields? |
Beta Was this translation helpful? Give feedback.
-
|
@ldez @RSS1102 Not sure why this suggestion is considered a joke, regex validation would be useful to make sure users are putting the correct information into a form when making an issue? |
Beta Was this translation helpful? Give feedback.
-
|
I just think that if they don't support the subject matter, it will be harder to gain support for your more radical ideas. |
Beta Was this translation helpful? Give feedback.
-
|
I don't consider your comment a joke: you ask "when" but GitHub should already hear the idea before knowing "when". Also, note that this idea is already inside the first comment: https://github.com/orgs/community/discussions/63402#discussioncomment-6697333 |
Beta Was this translation helpful? Give feedback.
-
|
Using @mentions in a For example, here's what I see when filling out the issue (note that I typed
But here's what renders when the issue has been submitted:
|
Beta Was this translation helpful? Give feedback.
-
|
Minor nit with the documentation in the GitHub Web UI. If you name a file Note: I only discovered this because I screwed something up and my issue submission form wasn't showing up, so I was trying to go WAY back to the simplest basics and start adding things in one by one until I discover why it's breaking. +100 for the above requests for some kind of "preview/validation" feature so that this sort of "brute force" debugging would no longer be necessary. :) |
Beta Was this translation helpful? Give feedback.
-
|
LOL, oh. AND it turns out that
|
Beta Was this translation helpful? Give feedback.
-
|
Good News: "required" is now working in Internal Repos! |
Beta Was this translation helpful? Give feedback.
-
|
One thing we wanted, especially with We can sort of do that with a YAML template form, but the label for the main We can do it with the markdown style issue template, but we'd really like a way to say "don't inject the label into the issue" for YAML form templates as well (or just don't make label mandatory) |
Beta Was this translation helpful? Give feedback.
-
|
It's not clear if this discussion is still being monitored, but I wanted to note a couple issues that came out of the @w3ctag's migration to issue forms for one repository: |
Beta Was this translation helpful? Give feedback.
-
|
Similarly, |
Beta Was this translation helpful? Give feedback.
-
|
🐞 We are no longer able to add issues to projects by using this yaml setup. It has been working for months, and suddenly stopped working last week. The latter used to work for us, now neither is working. |
Beta Was this translation helpful? Give feedback.
-
|
Agree not working for us also. |
Beta Was this translation helpful? Give feedback.
and others
Uh oh!
There was an error while loading. Please reload this page.
-
📢 Calling all issue management aficionados! We're embarking on a mission to improve GitHub issue forms and templates, and would love to hear from you!
💡 Share your creative ideas and experiences in crafting issue forms and templates that have made issue triaging a breeze. What fields, labels, or instructions have you include to ensure comprehensive and clear issue reporting? Are there any features missing that would help optimize this process? We're looking to help maintainers and admins set up the perfect balance between gathering necessary information and keeping the issue creation user-friendly.
🔍 Imagine you have a magic wand to create the ultimate GitHub issue form/template creation and management experience. What tools have you used in the past that made this a breeze? What features would help you manage and track issues across repositories, organizations and projects?
🐞 Run into any bugs with issue forms and templates? Let us know!
🤝 Let's collaborate and design a streamlined, intuitive, and impactful Join the discussion below and let the magic of collaboration begin! ✨
Beta Was this translation helpful? Give feedback.
All reactions