リポジトリでIssueやプルリクエストのテンプレートを作成すると、コントリビューターはそのテンプレートを使い、リポジトリのコントリビューションのガイドラインに沿ってIssuelをオープンしたり、プルリクエスト中の変更を提案したりできるようになります。 リポジトリへのコントリビューション ガイドラインの追加について詳しくは、「リポジトリコントリビューターのためのガイドラインを定める」をご覧ください。
Organization または個人アカウントのデフォルトの issue と pull request テンプレートを作成できます。 詳しくは、「既定のコミュニティ正常性ファイルの作成」を参照してください。
Issueのテンプレート
Issue テンプレートビルダーを使ってリポジトリの Issue テンプレートを作る場合、コントリビューターはリポジトリで新しい Issue をオープンするときに適切なテンプレートを選べます。
Issue テンプレートは、コントリビューターが Issue の内容を指定できるようにするとともに、Issue をオープンするためのガイダンスを提供する場合に役立ちます。
テンプレートビルダーを使うと、各テンプレートに対してタイトルと説明を指定し、テンプレートの内容を追加し、リポジトリ中でそのテンプレートをデフォルトブランチにコミットするか、プルリクエストをオープンできます。 テンプレートビルダーは、新しい Issue ページにテンプレートを表示するのに必要となる YAML front matter マークアップを自動的に追加してくれます。 詳しくは、「リポジトリ用に Issue テンプレートを設定する」を参照してください。
リポジトリで新しい Issue を作成する時に表示される Issue テンプレートの選択画面をカスタマイズするには、.github/ISSUE_TEMPLATE
フォルダーに config.yml
ファイルを追加します。詳しくは、「リポジトリ用に Issue テンプレートを設定する」をご覧ください。
Issue テンプレートは、リポジトリの既定のブランチの非表示 .github/ISSUE_TEMPLATE
のディレクトリに格納されます。 テンプレートを他のブランチで作成した場合、それをコラボレーターが使うことはできません。 Issue テンプレートのファイル名では大文字と小文字は区別されず、 .md 拡張子が必要です。 コミュニティ プロファイル チェックリストに チェックマーク付きで表示されるためには、issue テンプレートが .github/ISSUE_TEMPLATE
フォルダーに配置され、YAML frontmatter で有効な name:
と about:
キー (.md
ファイルで定義されている issue テンプレートの場合)、または有効な name:
と description:
キー (.yml
ファイルで定義されている issue フォームの場合) を、含んでいる必要があります。
レガシーの Issue テンプレートワークフローを使い、手作業で単一の Issue テンプレートを Markdown で作成することもできます。その場合、プロジェクトのコントリビューターは自動的に Issue の本文にテンプレートの内容を見ることになります。 しかしながら、アップグレードされた複数 Issue のテンプレートビルダー を使い Issue テンプレートを作ることをお勧めします。 レガシ ワークフローについて詳しくは、「リポジトリ用の単一 Issue テンプレートを手動で作成する」をご覧ください。
セキュリティポリシーを作成して、プロジェクト中のセキュリティ脆弱性を報告するための指示を出すことができます。 詳しくは、「リポジトリへのセキュリティ ポリシーの追加」を参照してください。
プル要求テンプレート
リポジトリにプルリクエストのテンプレートを追加すると、プロジェクトのコントリビューターはプルリクエストの本体にテンプレートの内容を自動的に見ることになります。
テンプレートは、リポジトリのデフォルトブランチに作成しなければなりません。 他のブランチに作成されたテンプレートは、コラボレーターが使用できません。 pull request テンプレートは、リポジトリの表示されているルート ディレクトリ、docs
フォルダー、または非表示の .github
ディレクトリに保存できます。 pull request テンプレートのファイル名は大文字と小文字が区別されず、拡張子は .md または .txt などを使用できます。
詳しくは、「リポジトリ用のプルリクエストテンプレートの作成」を参照してください。