52937ae5ca
Co-authored-by: Rachael Sewell <rachmari@github.com> Co-authored-by: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Co-authored-by: David Jarzebowski <davidjarzebowski@github.com> Co-authored-by: Anne-Marie <102995847+am-stead@users.noreply.github.com> Co-authored-by: Matt Pollard <mattpollard@users.noreply.github.com> Co-authored-by: Steve Guntrip <stevecat@github.com> Co-authored-by: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> Co-authored-by: Sam Browning <106113886+sabrowning1@users.noreply.github.com> Co-authored-by: Torsten Walter <torstenwalter@github.com> Co-authored-by: Henry Mercer <henrymercer@github.com> Co-authored-by: Sarah Edwards <skedwards88@github.com>
2.5 KiB
title, shortTitle, intro, versions
| title | shortTitle | intro | versions | ||
|---|---|---|---|---|---|
| Creating discussion category forms | Create discussion category forms | You can customize the templates that are available for community members to use when they open new discussions in your repository. |
|
About discussion category forms
You can encourage community members to include specific, structured information in their discussions by using discussion forms in your repository. With discussion category forms, you can create discussion templates that have customizable web form fields. Discussion forms are written in YAML using the {% data variables.product.prodname_dotcom %} form schema. For more information, see "AUTOTITLE."
{% data reusables.actions.learn-more-about-yaml %}
To use a discussion category form in your repository, you must create a new file and add it to the /.github/DISCUSSION_TEMPLATE/ folder in your repository.
You can also create discussion category forms for your organization. For more information, see "AUTOTITLE."
Discussion category forms are not supported for polls. For more information about polls, see "AUTOTITLE."
Here is the rendered version of the issue form.
Creating discussion category forms
People with write access to a repository can create a discussion category form.
- Navigate to the repository where you want to create a discussion category form.
- In your repository, create a file called
/.github/DISCUSSION_TEMPLATE/FORM-NAME.yml, replacingFORM-NAMEwith the name for your discussion category form. {% data reusables.discussions.discussion-category-forms-name %} For more information about creating new files on GitHub, see "AUTOTITLE." - In the body of the new file, type the contents of your discussion category form. For more information, see "AUTOTITLE."
- Commit your file to the default branch of your repository. For more information, see "AUTOTITLE."