# ディスカッション カテゴリ フォームの作成

コミュニティのメンバーがリポジトリで新しいディスカッションを開くときに使えるテンプレートをカスタマイズできます。

## ディスカッション カテゴリ フォームについて

リポジトリ内でディスカッション フォームを使って、コミュニティ メンバーがディスカッションに特定の構造化された情報を含めるよう促すことができます。 ディスカッション カテゴリ フォームを使うと、カスタマイズできる Web フォーム フィールドがあるディスカッション テンプレートを作成できます。 ディスカッション フォームは、 GitHub フォーム スキーマを使用して YAML で記述されます。 詳しくは、「[GitHubのフォーム スキーマの構文](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema)」をご覧ください。

YAML の初心者で詳しく学びたい場合は、「[Learn YAML in Y minutes](https://learnxinyminutes.com/docs/yaml/)」(YAML を Y 分で学ぶ) を参照してください。

リポジトリでディスカッション カテゴリ フォームを使うには、新しいファイルを作成して、それをお使いのリポジトリの `/.github/DISCUSSION_TEMPLATE/` フォルダーに追加する必要があります。

あなたの組織のためにディスカッションカテゴリフォームを作成することもできます。 詳しくは、「[既定のコミュニティ正常性ファイルの作成](/ja/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)」をご覧ください。

ディスカッション カテゴリ フォームは、投票ではサポートされていません。 投票の詳細については、「[ディスカッションについて](/ja/discussions/collaborating-with-your-community-using-discussions/about-discussions)」を参照してください。

Issueフォームのレンダリングバージョンは次のとおりです。

![レンダリングされたディスカッション カテゴリ フォームのスクリーンショット。](/assets/images/help/discussions/discussion-category-form-sample.png)

## ディスカッション カテゴリ フォームの作成

ディスカッション カテゴリ フォームは、リポジトリへの書き込みアクセス権を持つユーザーが作成できます。

1. ディスカッション カテゴリ フォームを作成するリポジトリに移動します。
2. リポジトリで、`/.github/DISCUSSION_TEMPLATE/FORM-NAME.yml` をディスカッション カテゴリ フォーム フォームの名前に置き換えて、`FORM-NAME` という名前のファイルを作成します。
   名前は、いずれかのディスカッション カテゴリのスラッグに対応している必要があります。 たとえば、"Announcements" カテゴリのテンプレートは、`.github/DISCUSSION_TEMPLATE/announcements.yml` にする必要があります。GitHubでの新しいファイルの作成の詳細については、「[新しいファイルの作成](/ja/repositories/working-with-files/managing-files/creating-new-files)」を参照してください。
3. 新しいファイルの本文に、ディスカッション カテゴリ フォームの内容を入力します。 詳しくは、「[ディスカッション カテゴリ フォームの構文](/ja/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms)」をご覧ください。
4. ファイルをリポジトリのデフォルトブランチにコミットします。 詳しくは、「[新しいファイルの作成](/ja/repositories/working-with-files/managing-files/creating-new-files)」をご覧ください。