跳至主要内容

为仓库贡献者设置指南

您可以创建指南来传达人们应该如何为您的项目做出贡献。

关于贡献指南

为了帮助您的项目贡献者做好工作,您可以在项目的根目录、docs.github 文件夹中添加一个包含贡献指南的文件。当有人打开拉取请求或创建问题时,他们会看到指向该文件的链接。贡献指南的链接也会出现在您的仓库的 contribute 页面上。有关 contribute 页面的示例,请参阅 github/docs/contribute

对于仓库所有者来说,贡献指南是一种传达人们应该如何做出贡献的方式。

对于贡献者来说,指南可以帮助他们验证他们是否提交了格式良好的拉取请求并打开了有用的问题。

对于所有者和贡献者来说,贡献指南可以节省因创建不当的拉取请求或必须拒绝并重新提交的问题而造成的时间和麻烦。

您可以为您的组织或个人帐户创建默认的贡献指南。有关更多信息,请参阅“创建默认社区健康文件”。

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

添加 CONTRIBUTING 文件

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

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

    或者,您可以点击 左侧的文件树视图。

    Screenshot of the main page of a repository. Above the list of files, a button, labeled "Add file," is outlined in dark orange. In the file tree view of the repository, a button with a plus sign icon is also outlined in dark orange.

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

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

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

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

  7. 在提交消息字段下方,决定是将您的提交添加到当前分支还是添加到新分支。如果您的当前分支是默认分支,您应该选择为您的提交创建一个新分支,然后创建一个拉取请求。有关更多信息,请参阅“创建拉取请求”。

    Screenshot of a GitHub pull request showing a radio button to commit directly to the main branch or to create a new branch. New branch is selected.

  8. 点击 提交更改提出更改

贡献指南示例

如果您感到困惑,这里有一些贡献指南的良好示例

进一步阅读