Skip to main content

设置仓库参与者指南

您可以创建告知人们应如何参与您的项目的指南。

关于参与指南

为帮助项目参与者做好工作,可以将含有参与指南的文件添加到项目存储库的根目录、docs.github 文件夹。 有人打开拉取请求或创建议题时,他们将看到指向该文件的链接。 参与指南的链接也会出现在存储库的 contribute 页。 有关 contribute 页面的示例,请参阅 github/docs/contribute

对于仓库所有者,参与指南是告知人们应如何参与的一种途径。

对于参与者,该指南帮助他们确认其提交格式规范的拉取请求和打开有用的议题。

对于所有者和参与者来说,参与指南节省了由于不正确创建必须拒绝和重新提交的拉取请求或议题而导致的时间和麻烦。

你可以为组织或个人帐户创建默认的参与指南。 有关详细信息,请参阅“创建默认的社区运行状况文件”。

提示:存储库维护员可以通过为存储库创建问题或拉取请求模板来设置问题的特定指南。 有关详细信息,请参阅“关于议题和拉取请求模板”。

添加 CONTRIBUTING 文件

  1. 在 GitHub.com 上,导航到存储库的主页。

  2. 在文件列表上方,选择“添加文件” 下拉菜单,然后单击“ 创建新文件” 。

    也可在左侧的文件树状视图中单击

    存储库主页的屏幕截图。 在文件列表上方,标有“添加文件”的按钮以深橙色框出。 在存储库的文件树状视图中,带加号图标的按钮也以深橙色框出。

  3. 决定是在存储库的根目录、docs 还是 .github 目录中存储你的参与指南。 然后,在文件名字段中,输入文件的名称和扩展名。 参与指南文件名不区分大小写。 如果文件扩展名为支持的格式,文件会以富文本格式呈现。 有关详细信息,请参阅“使用非代码文件”。

    • 要使参与指南在存储库的根目录中显示,请键入“CONTRIBUTING”。
    • 要使参与指南在存储库的 docs 目录中可见,请键入“docs/”以创建新目录,然后键入“CONTRIBUTING” 。
    • 如果存储库包含多个 CONTRIBUTING 文件,则按以下顺序从各位置中选择链接中显示的文件:.github 目录,然后是存储库的根目录,最后是 docs 目录。
  4. 在新文件中,添加参与指南。 这些可能包括:

    • 创建良好议题或拉取请求的步骤。
    • 指向外部文档、邮件列表或行为准则的链接。
    • 社区和行为预期。
  5. 单击“提交更改...”

  6. 在“提交消息”字段中,输入简短、有意义的提交消息,以描述对文件的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息,请参阅“创建有多个作者的提交”。

  7. 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支,则应选择为提交创建新分支,然后创建拉取请求。 有关详细信息,请参阅“创建拉取请求”。

    GitHub 拉取请求的屏幕截图,其中显示了一个单选按钮,用于直接提交到主分支或创建新分支。 已选择“新建分支”。

  8. 单击“提交更改”或“建议更改” 。

参与指南示例

如果您觉得难以着手,以下是参与指南的一些良好示例:

延伸阅读