既定のコミュニティ正常性ファイルの作成

デフォルトのコミュニティ健全性ファイルについて

既定のコミュニティ正常性ファイルは、正常で共同作業のopen source プロジェクトを維持するためのガイダンスとテンプレートを提供する定義済みのファイルのセットです。これらのファイルは、プロジェクトの開発とコミュニティの相互作用のさまざまな側面を自動化および標準化し、透明性、優れたプラクティス、コラボレーションを促進するのに役立ちます。

既定のコミュニティ正常性ファイルを public または internal リポジトリに追加できます。GitHub は、その種類の独自のファイルを持たないアカウントが所有するすべてのリポジトリの既定のファイルを次の順序で使用して表示します。

```
        `.github` フォルダー
```
リポジトリのルート
```
        `docs` フォルダー
```

現在のリポジトリに対応するファイルが見つからない場合、GitHub は、同じ優先順位に従って .github リポジトリの既定のファイルを使用します。

メモ

既定のコミュニティ正常性ファイルを組織全体で適用するには、 .github リポジトリが public または internal である必要があります。プライベート .github リポジトリはサポートされていません。ただし、issue およびプルリクエストテンプレートにはパブリック .github リポジトリが必要であり、内部リポジトリから組織全体に適用されません。

たとえば、独自の CONTRIBUTING.md ファイルを持たないリポジトリで issue または pull request を作成したユーザーには、CONTRIBUTING.md リポジトリからの既定の .github へのリンクが表示されます。ただし、リポジトリの独自の .github/ISSUE_TEMPLATE フォルダーに、たとえば issue テンプレートや _config.yml ファイルなどの何らかのファイルがある場合、既定の .github/ISSUE_TEMPLATE フォルダーの内容は使用されません。これにより、リポジトリの保守担当者は、リポジトリごとに既定のファイルを具体的なテンプレートまたは内容でオーバーライドできるようになります。

          `.github` リポジトリにファイルを格納すると、既定値を 1 か所で変更できます。 さらに、それらは個々のリポジトリのファイル ブラウザーまたは Git 履歴には表示されず、クローン、パッケージ、またはダウンロードには含まれません。

セキュリティポリシーについて

セキュリティの報告の指示を明確に利用できる要することで、ユーザがあなたの好むコミュニケーションチャンネルを使ってリポジトリで見つけたセキュリティ脆弱性を報告することを容易にできます。

実際の SECURITY.md ファイルの例については、「https://github.com/electron/electron/blob/main/SECURITY.md」を参照してください。

サポートされるファイルの種類

次のコミュニティ正常性ファイルのデフォルトを、組織または個人用アカウントに作成できます。

コミュニティ正常性ファイル	説明

          _CONTRIBUTING.md_ | CONTRIBUTING ファイルは、ユーザーがプロジェクトに貢献する方法を伝えるものです。 詳しくは、「[AUTOTITLE](/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors)」をご覧ください。 |

| ディスカッションカテゴリフォーム | ディスカッションカテゴリフォームは、コミュニティのメンバーがリポジトリで新しいディスカッションを開くときに使えるテンプレートをカスタマイズできます。詳しくは、「ディスカッションカテゴリフォームの作成」をご覧ください。 | | | | GOVERNANCE.md | GOVERNANCE ファイルは、プロジェクトの管理方法をユーザーに通知します。たとえば、プロジェクトロールと意思決定の方法について説明する可能性があります。 | | イシューと pull request のテンプレートおよび config.yml | Issue 及び pull request のテンプレートを使用すると、コントリビューターがリポジトリでIssuleやプルリクエストをオープンする際に含めてほしい情報をカスタマイズし、標準化できます。詳しくは、「Issueとプルリクエストのテンプレートについて」をご覧ください。

問題テンプレートにラベルがある場合、そのラベルは、.github リポジトリとテンプレートが使用されるすべてのリポジトリに作成する必要があります。組織全体で使用する問題およびプルリクエスト用テンプレートにおいて、.githubリポジトリは公開設定にする必要があります。 | | SECURITY.md | SECURITY ファイルでは、プロジェクトおよびファイルにハイパーリンクされる説明でセキュリティ脆弱性を報告する方法の手順が示されます。詳しくは、「リポジトリへのセキュリティポリシーの追加」をご覧ください。 | | SUPPORT.md | SUPPORT ファイルは、プロジェクトを支援する方法をユーザーに通知します。詳しくは、「プロジェクトへのサポートリソースの追加」をご覧ください。 |

デフォルトのライセンスファイルを作成することはできません。ライセンスファイルは、プロジェクトのクローン時、パッケージ時、またはダウンロード時に含められるよう、個々のリポジトリに追加する必要があります。

デフォルトのファイル用にリポジトリを作成

ページの右上隅でを選択し、 [新しいリポジトリ] をクリックします。

          **[所有者]** ドロップダウン メニューを使用し、デフォルトのファイルを作成する組織または個人用アカウントを選択します。

       ![新しい GitHub リポジトリの所有者メニューのスクリーンショット。 メニューには、octocat と github の 2 つのオプションが表示されます。](/assets/images/help/repository/create-repository-owner.png)

[リポジトリ名] フィールドに「 .github」と入力します。
あるいは、[説明] フィールドに説明を入力します。
リポジトリの状態が Public または Internal に設定されていることを確認します。既定のファイルのリポジトリをプライベートにすることはできません。
[ README の追加 ] を [オン] に切り替えます。
[Create repository] (リポジトリの作成) をクリックします。
リポジトリの中に、サポートされているコミュニティ健全性ファイルの 1 つを作成します。 Issue テンプレートとその構成ファイルは、.github/ISSUE_TEMPLATE という名前のフォルダーに存在する必要があります。他のすべてのサポートされるファイルは、リポジトリのルート、.github フォルダー、または docs フォルダーに置くことができます。詳しくは、「新しいファイルの作成」をご覧ください。

既定のコミュニティ正常性ファイルの作成

この記事で

デフォルトのコミュニティ健全性ファイルについて

セキュリティポリシーについて

サポートされるファイルの種類

デフォルトのファイル用にリポジトリを作成