Skip to main content

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

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

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

リポジトリ内でディスカッション フォームを使って、コミュニティ メンバーがディスカッションに特定の構造化された情報を含めるよう促すことができます。 ディスカッション カテゴリ フォームを使うと、カスタマイズできる Web フォーム フィールドがあるディスカッション テンプレートを作成できます。 ディスカッション フォームは、GitHub フォーム スキーマを使って YAML で記述します。 詳しくは、「GitHub のフォームスキーマの構文」を参照してください。

YAML を初めて使用する場合は、「Learn YAML in Y minutes」 (YAML を Y 分で学習する) を参照してください。

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

Organization 用にディスカッション カテゴリ フォームを作成することもできます。 詳しくは、「既定のコミュニティ正常性ファイルの作成」を参照してください。

ディスカッション カテゴリ フォームは、投票ではサポートされていません。 投票について詳しくは、「ディスカッションについて」をご覧ください。

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

レンダリングされたディスカッション カテゴリ フォームのスクリーンショット。

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

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

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