Skip to main content

Issueとプルリクエストのテンプレートについて

Issue及びプルリクエストのテンプレートを使えば、コントリビューターがリポジトリでIssuleやプルリクエストをオープンする際に含めてほしい情報をカスタマイズし、標準化できます。

リポジトリでIssueやプルリクエストのテンプレートを作成すると、コントリビューターはそのテンプレートを使い、リポジトリのコントリビューションのガイドラインに沿ってIssuelをオープンしたり、プルリクエスト中の変更を提案したりできるようになります。 リポジトリへのコントリビューション ガイドラインの追加について詳しくは、「リポジトリコントリビューターのためのガイドラインを定める」をご覧ください。

Organization または個人アカウントのデフォルトの issue と pull request テンプレートを作成できます。 詳しくは、「既定のコミュニティ正常性ファイルの作成」を参照してください。

Issueのテンプレート

Issue テンプレートビルダーまたは Issue フォームを使ってリポジトリの Issue テンプレートを作る場合、コントリビューターはリポジトリで新しい Issue をオープンするときに適切なテンプレートを選べます。

選択できる複数のテンプレートが表示されている新しい issue ページのスクリーンショット。

Issue テンプレートは、コントリビューターが Issue の内容を指定できるようにするとともに、Issue をオープンするためのガイダンスを提供する場合に役立ちます。 コントリビューターが Issue をオープンするときに特定の構造化された情報を提供する場合は、Issue フォームを使用すると、必要な情報を確実に受け取ることができます。

テンプレートビルダーを使うと、各テンプレートに対してタイトルと説明を指定し、テンプレートの内容を追加し、リポジトリ中でそのテンプレートをデフォルトブランチにコミットするか、プルリクエストをオープンできます。 テンプレートビルダーは、新しい Issue ページにテンプレートを表示するのに必要となる YAML front matter マークアップを自動的に追加してくれます。 詳しくは、「リポジトリ用に Issue テンプレートを設定する」を参照してください。

Issue フォームでは、GitHub フォーム スキーマを使い、Web フォーム フィールドを含むテンプレートを作れます。 コントリビューターが Issue フォームを使用して Issue をオープンすると、フォーム入力は標準のマークダウン Issue コメントに変換されます。 さまざまな入力タイプを指定し、必要に応じて入力を設定して、コントリビューターがリポジトリで実行可能な Issue をオープンすることができるようにすることができます。 詳細については、「リポジトリ用に Issue テンプレートを設定する」および「Issue フォームの構文」を参照してください。

リポジトリで新しい Issue を作成する時に表示される Issue テンプレートの選択画面をカスタマイズするには、.github/ISSUE_TEMPLATE フォルダーに config.yml ファイルを追加します。詳しくは、「リポジトリ用に Issue テンプレートを設定する」をご覧ください。

Issue テンプレートは、リポジトリの既定のブランチの非表示 .github/ISSUE_TEMPLATE のディレクトリに格納されます。 テンプレートを他のブランチで作成した場合、それをコラボレーターが使うことはできません。 Issue テンプレートのファイル名では大文字と小文字は区別されず、 .md 拡張子が必要です。 Issue フォームで作成された Issue テンプレートには、 .yml 拡張子が必要です。 コミュニティ プロファイル チェックリストに チェックマーク付きで表示されるためには、issue テンプレートが .github/ISSUE_TEMPLATE フォルダーに配置され、YAML frontmatter で有効な name:about: キー (.md ファイルで定義されている issue テンプレートの場合)、または有効な name:description: キー (.yml ファイルで定義されている issue フォームの場合) を、含んでいる必要があります。

レガシーの Issue テンプレートワークフローを使い、手作業で単一の Issue テンプレートを Markdown で作成することもできます。その場合、プロジェクトのコントリビューターは自動的に Issue の本文にテンプレートの内容を見ることになります。 しかしながら、アップグレードされた複数 Issue のテンプレートビルダー または Issue フォーム を使い Issue テンプレートを作ることをお勧めします。 レガシ ワークフローについて詳しくは、「リポジトリ用の単一 Issue テンプレートを手動で作成する」をご覧ください。

セキュリティポリシーを作成して、プロジェクト中のセキュリティ脆弱性を報告するための指示を出すことができます。 詳しくは、「リポジトリへのセキュリティ ポリシーの追加」を参照してください。

プル要求テンプレート

リポジトリにプルリクエストのテンプレートを追加すると、プロジェクトのコントリビューターはプルリクエストの本体にテンプレートの内容を自動的に見ることになります。

テンプレートは、リポジトリのデフォルトブランチに作成しなければなりません。 他のブランチに作成されたテンプレートは、コラボレーターが使用できません。 pull request テンプレートは、リポジトリの表示されているルート ディレクトリ、docs フォルダー、または非表示の .github ディレクトリに保存できます。 pull request テンプレートのファイル名は大文字と小文字が区別されず、拡張子は .md または .txt などを使用できます。

詳しくは、「リポジトリ用のプルリクエストテンプレートの作成」を参照してください。