詳しくは、「Issueとプルリクエストのテンプレートについて」をご覧ください。
サポートしているどのフォルダーでも PULL_REQUEST_TEMPLATE/ サブディレクトリを作成し、pull request テンプレートを複数含めることができます。また、template クエリ パラメーターで pull request の本文に使用するテンプレートを指定できます。 詳しくは、「クエリ パラメーターを使って pull request を作成する」をご覧ください。
Organization または個人用アカウントのデフォルトの pull request テンプレートを作成できます。 詳しくは、「既定のコミュニティ正常性ファイルの作成」をご覧ください。
プルリクエストテンプレートの追加
-
GitHub で、リポジトリのメイン ページに移動します。
-
ファイルの一覧の上にある、 [ファイルの追加] ドロップダウンを使用し、 [新しいファイルの作成] をクリックします。
-
ファイル名フィールドで:
- pull request テンプレートをリポジトリのルート ディレクトリで表示するには、pull request テンプレートに
pull_request_template.mdという名前を付けます。 - pull request テンプレートをリポジトリの
docsディレクトリで表示するには、pull request テンプレートにdocs/pull_request_template.mdという名前を付けます。 - ファイルを非表示のディレクトリに格納するには、pull request テンプレートを
.github/pull_request_template.mdという名前にします。 - pull request テンプレートを複数作成し、
templateクエリ パラメーターを使用して pull request の本文を埋めるテンプレートを指定するには、 .github/PULL_REQUEST_TEMPLATE/ と入力し、続けてお使いの pull request テンプレートの名前を入力します。 たとえば、「.github/PULL_REQUEST_TEMPLATE/pull_request_template.md」のように入力します。 ルートまたはdocs/ディレクトリ内のPULL_REQUEST_TEMPLATEサブディレクトリに複数の pull request テンプレートを格納することもできます。 詳しくは、「クエリ パラメーターを使って pull request を作成する」をご覧ください。
- pull request テンプレートをリポジトリのルート ディレクトリで表示するには、pull request テンプレートに
-
新しいファイルの本文にプルリクエストテンプレートを追加します。 このテンプレートは、次を含むことを要求するように構成できます。
- ご自分のリポジトリ内の 関連する Issue への参照。
- プルリクエストで提案された変更の説明。
- レビューを行っている提案された変更の責任を負う個人またはチームの @mentions。
-
[コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「複数の作者を持つコミットを作成する」を参照してください。
-
コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「pull request の作成」を参照してください。
テンプレートがリポジトリの既定のブランチにマージされると、コラボレーターがテンプレートを使用できるようになります。
-
[変更のコミット] または [変更の提案] をクリックします。
