关于贡献指南
为了帮助您的项目贡献者做好工作,您可以在项目的根目录、docs
或 .github
文件夹中添加一个包含贡献指南的文件。当有人打开拉取请求或创建问题时,他们会看到指向该文件的链接。贡献指南的链接也会出现在您的仓库的 contribute
页面上。有关 contribute
页面的示例,请参阅 github/docs/contribute。
对于仓库所有者来说,贡献指南是一种传达人们应该如何做出贡献的方式。
对于贡献者来说,指南可以帮助他们验证他们是否提交了格式良好的拉取请求并打开了有用的问题。
对于所有者和贡献者来说,贡献指南可以节省因创建不当的拉取请求或必须拒绝并重新提交的问题而造成的时间和麻烦。
您可以为您的组织或个人帐户创建默认的贡献指南。有关更多信息,请参阅“创建默认社区健康文件”。
提示: 仓库维护者可以通过为仓库创建问题或拉取请求模板来设置特定问题的指南。有关更多信息,请参阅“关于问题和拉取请求模板”。
添加 CONTRIBUTING 文件
-
在 GitHub.com 上,导航到仓库的主页。
-
在文件列表上方,选择 **添加文件** 下拉菜单,然后点击 创建新文件.
或者,您可以点击 左侧的文件树视图。
-
决定是否将您的贡献指南存储在仓库的根目录、
docs
或.github
目录中。然后,在文件名字段中,输入文件的名称和扩展名。贡献指南文件名不区分大小写。如果文件扩展名是支持的格式,则文件将以富文本格式呈现。有关更多信息,请参阅“使用非代码文件”。- 要使您的贡献指南在仓库的根目录中可见,请输入 CONTRIBUTING。
- 要使您的贡献指南在仓库的
docs
目录中可见,请输入 docs/ 以创建新目录,然后输入 CONTRIBUTING。 - 如果仓库包含多个 CONTRIBUTING 文件,则链接中显示的文件将从以下位置按顺序选择:
.github
目录,然后是仓库的根目录,最后是docs
目录。
-
在新文件中,添加贡献指南。这些可能包括
- 创建良好问题或拉取请求的步骤。
- 指向外部文档、邮件列表或行为准则的链接。
- 社区和行为期望。
-
点击 提交更改...
-
在“提交消息”字段中,输入一个简短、有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。有关更多信息,请参阅“创建具有多个作者的提交”。
-
在提交消息字段下方,决定是将您的提交添加到当前分支还是添加到新分支。如果您的当前分支是默认分支,您应该选择为您的提交创建一个新分支,然后创建一个拉取请求。有关更多信息,请参阅“创建拉取请求”。
-
点击 提交更改 或 提出更改。
贡献指南示例
如果您感到困惑,这里有一些贡献指南的良好示例