创建默认的社区运行状况文件

关于默认社区健康文件

默认社区健康文件是一组预定义文件，提供指导和模板，用于维护健康且协作的开源项目。这些文件有助于你实现项目开发及社区互动各个方面的自动化和标准化，促进透明度、最佳做法及协作。

可以将默认社区运行状况文件添加到名为的公共或存储库，GitHub 将按以下顺序使用和显示帐户拥有的任何存储库的默认文件，这些存储库没有自己的该类型文件：

如果在当前存储库中找不到相应的文件，GitHub 将按照相同的优先级顺序使用存储库中的默认文件。

注意

存储库必须是公开才能在整个组织中应用模板。不支持专用存储库。

例如，在不含自有文件的存储库中创建问题或拉取请求的人将会看到存储库中默认的链接。然而，如果存储库在其自己的文件夹中有任何文件（如问题模板或文件），则不会使用默认文件夹的任何内容。这允许存储库维护人员在每个存储库的基础上用特定的模板或内容覆盖默认文件。

将文件存储在存储库中允许只在一个位置更改默认值。此外，它们不会出现在单个存储库的文件浏览器或 Git 历史记录中，也不会包含在其克隆、包或下载中。

通过创建明确的安全报告说明，用户可以轻松地使用你喜欢的通信通道报告仓库中发现的任何安全漏洞。

有关真实文件的示例，请参阅。

可以在组织或个人帐户中为以下社区运行状况文件创建默认内容：

社区健康文件	说明
CONTRIBUTING.md	CONTRIBUTING 文件说明了人们应该如何参与项目。有关详细信息，请参阅“AUTOTITLE”。
讨论类别表单	讨论类别表单可自定义模板，供社区成员在存储库中打开新讨论时使用。有关详细信息，请参阅“AUTOTITLE”。
GOVERNANCE.md	GOVERNANCE 文件让人们了解项目是如何治理的。例如，其中可能会讨论项目角色以及如何做出决策。
问题和拉取请求模板，以及 config.yml	问题和拉取请求模板可自定义和标准化你希望参与者在存储库中打开问题和拉取请求时添加的信息。有关详细信息，请参阅“AUTOTITLE”。如果问题模板设置了标签，则必须在存储库和将使用该模板的任何存储库中创建该标签。
SECURITY.md	安全性文件提供了如何报告项目中的安全漏洞的说明，以及对该文件进行超链接的描述。有关详细信息，请参阅“AUTOTITLE”。
SUPPORT.md	SUPPORT 文件可让人们了解获得项目帮助的途径。有关详细信息，请参阅“AUTOTITLE”。

您不能创建默认许可文件。必须将许可文件添加到各个仓库中，以便在克隆、打包或下载项目时包含该文件。

在任何页面的右上角，选择，然后单击“新建存储库”。
使用“所有者”下拉菜单，选择要为其创建默认文件的组织或个人帐户。新 GitHub 存储库的所有者菜单的屏幕截图。菜单显示两个选项：“octocat”和“github”。
在“存储库名称”字段中，键入 .github。
（可选）在“描述”字段中键入描述。
确保存储库状态设置为 Public。默认文件的存储库不能是专用的。
将 README 切换为开启。
单击“创建存储库”。
在仓库中，创建一个受支持的社区健康文件。议题模板及其配置文件必须位于名为的文件夹中。所有其他支持的文件可能位于存储库根目录、文件夹或文件夹中。有关详细信息，请参阅“AUTOTITLE”。