リポジトリ用の単一 Issue テンプレートを手動で作成する

手動で作成した Issue テンプレートをリポジトリに追加すると、プロジェクトのコントリビューターは自動的に Issue の本体でテンプレートの内容が見えるようになります。

ここには以下の内容があります:

Issue テンプレートを追加する
参考リンク

これはIssueテンプレートを作成するためのレガシーのワークフローです。複数のIssue テンプレートの作成にはアップグレードされた複数 Issue テンプレートビルダーを使うことをおすすめします。詳しい情報についてはIssue およびプルリクエストのテンプレートについてを参照してください。

サポートしているどのフォルダーにでも ISSUE_TEMPLATE/ サブディレクトリを作成し、Issue テンプレートを複数含めることができます。また、template クエリパラメータで Issue の本文に使用するテンプレートを指定できます。詳細は「クエリパラメータによる Issue およびプルリクエストの自動化について」を参照してください。

YAML frontmatter を各 Issue テンプレートに追加して、Issue のタイトルを事前に入力したり、ラベルおよびアサインされた人を自動追加したり、リポジトリに新しい Issue を作成するときに表示されるテンプレート選択画面に表示されるテンプレートの名前と説明を指定したりすることができます。

YAML front matter の例は次のとおりです。

---
name: Tracking issue
about: Use this template for tracking new features.
title: "[DATE]: [FEATURE NAME]"
labels: tracking issue, needs triage
assignees: octocat
---

Note: If a front matter value includes a YAML-reserved character such as : , you must put the whole value in quotes. For example, ":bug: Bug" or ":new: triage needed, :bug: bug".

You can create default issue templates for your organization. 詳しい情報については「デフォルトのコミュニティ健全性ファイルを作成する」を参照してください。

Issue テンプレートを追加する

GitHub Enterprise Serverで、リポジトリのメインページにアクセスしてください。
Above the list of files, click Create new file.
ファイル名フィールドで:
- Issue テンプレートをリポジトリのルートディレクトリで表示するには、issue_template の名前を入力します。たとえば、issue_template.md です。
- リポジトリの docs ディレクトリに Issue テンプレートを表示するには、docs/ に続けて issue_template の名前を入力します。たとえば、docs/issue_template.md です。
- ファイルを隠しディレクトリに格納するには、.github/ と入力し、続いて issue_template という名前を入力します。たとえば、.github/issue_template.md です。
- 複数 Issue テンプレートを作成し、template クエリパラメータを使用して Issue の本文に使用するテンプレートを指定するには、.github/ISSUE_TEMPLATE/ と入力し、続けて Issue テンプレートの名前を入力します。たとえば、.github/ISSUE_TEMPLATE/issue_template.md です。複数 Issue テンプレートをルートディレクトリや docs/ ディレクトリにある ISSUE_TEMPLATE サブディレクトリに格納することもできます。詳細は「クエリパラメータによる Issue およびプルリクエストの自動化について」を参照してください。
新しいファイルの本文に Issue テンプレートを追加します。そこに盛り込むべき項目として、以下のようなものがあります:
- YAML frontmatter
- 予測される動作と実際の動作
- 問題の再現手順
- プロジェクトのベンダー、オペレーティングシステム、ハードウェアなどの仕様
ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してください。コミットメッセージでは、複数の作者にコミットを関連づけることができます。詳しい情報については「複数の共作者を持つコミットの作成」を参照してください。
コミットメッセージフィールドの下で、コミットを追加を現在のブランチか新しいブランチから選択してください。 If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. 詳しい情報については「新しいプルリクエストの作成」を参照してください。
テンプレートがリポジトリのデフォルトブランチにマージされると、コラボレーターがテンプレートを使用できるようになります。
Propose new file（新規ファイルの提案）をクリックしてください。