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

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

リポジトリでIssueやプルリクエストのテンプレートを作成すると、コントリビューターはそのテンプレートを使い、リポジトリのコントリビューションのガイドラインに沿ってIssuelをオープンしたり、プルリクエスト中の変更を提案したりできるようになります。 リポジトリへのコントリビューション ガイドラインの追加の詳細については、「[リポジトリコントリビューターのためのガイドラインを定める](/ja/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors)」を参照してください。

Organization または個人アカウントのデフォルトの issue と pull request テンプレートを作成できます。 詳しくは、「[既定のコミュニティ正常性ファイルの作成](/ja/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)」をご覧ください。

## Issueのテンプレート

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

![選択できる複数のテンプレートが表示されている新しい issue ページのスクリーンショット。](/assets/images/help/issues/new-issue-page-with-multiple-templates.png)

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

テンプレートビルダーを使うと、各テンプレートに対してタイトルと説明を指定し、テンプレートの内容を追加し、リポジトリ中でそのテンプレートをデフォルトブランチにコミットするか、プルリクエストをオープンできます。 テンプレートビルダーは、新しい Issue ページにテンプレートを表示するのに必要となる YAML front matter マークアップを自動的に追加してくれます。 詳しくは、「[リポジトリ用に Issue テンプレートを設定する](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository)」をご覧ください。

Issue フォームでは、GitHub フォーム スキーマを使用して、Web フォーム フィールドを含むテンプレートを作成できます。 コントリビューターが Issue フォームを使用して Issue をオープンすると、フォーム入力は標準のマークダウン Issue コメントに変換されます。 さまざまな入力タイプを指定し、必要に応じて入力を設定して、コントリビューターがリポジトリで実行可能な Issue をオープンすることができるようにすることができます。 詳細については、「[リポジトリ用に Issue テンプレートを設定する](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#creating-issue-forms)」および「[課題書式の構文](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms)」を参照してください。

リポジトリで新しい Issue を作成する時に表示される Issue テンプレートの選択画面をカスタマイズするには、`.github/ISSUE_TEMPLATE` フォルダーに `config.yml` ファイルを追加します。 詳細については、「[リポジトリ用に Issue テンプレートを設定する](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser)」を参照してください。

Issue テンプレートは、リポジトリの既定のブランチの非表示 `.github/ISSUE_TEMPLATE` のディレクトリに格納されます。 テンプレートを他のブランチで作成した場合、それをコラボレーターが使うことはできません。 Issue テンプレートのファイル名では大文字と小文字が区別されません。また、拡張子は *.md* にする必要があります。 Issue フォームを使用して作成した issue テンプレートは、拡張子を *.yml* にする必要があります。 コミュニティ プロファイル チェックリストに <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Added" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> チェックマーク付きで表示されるためには、issue テンプレートが `.github/ISSUE_TEMPLATE` フォルダーに配置され、YAML frontmatter で有効な `name:` と `about:` キー (`.md` ファイルで定義されている issue テンプレートの場合)、または有効な `name:` と `description:` キー (`.yml` ファイルで定義されている issue フォームの場合) を、含んでいる必要があります。

セキュリティポリシーを作成して、プロジェクト中のセキュリティ脆弱性を報告するための指示を出すことができます。 詳しくは、「[リポジトリへのセキュリティ ポリシーの追加](/ja/code-security/getting-started/adding-a-security-policy-to-your-repository)」をご覧ください。

## プル要求テンプレート

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

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

詳しくは、「[リポジトリ用のプルリクエストテンプレートの作成](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository)」をご覧ください。