FirstContribution

FirstContribution

很难。第一次做某事总是很难。尤其是当您进行合作时，犯错误并不舒服。我们想简化新的开源贡献者首次学习和贡献的方式。

阅读文章和观看教程可以提供帮助，但是有什么比在练习环境中实际做这些事情更好？该项目旨在提供指导并简化初学者做出首次贡献的方式。如果您想做出第一个贡献，请按照以下步骤操作。

如果您的计算机上没有git，请安装它。

叉这个存储库

通过单击此页面顶部的“叉”按钮来分叉此存储库。这将在您的帐户中创建此存储库的副本。

克隆存储库

现在，将叉子存储库克隆到您的计算机上。转到您的GitHub帐户，打开叉子存储库，单击“克隆”按钮，然后单击副本到剪贴板图标。

打开终端并运行以下git命令：

 git clone "url you just copied"

在“您刚刚复制的URL”（没有报价标记）的地方是该存储库的URL（您的该项目的叉子）。请参阅前面的步骤以获取URL。

例如：

 git clone https://github.com/this-is-you/FirstContribution.git

在this-is-you是您的github用户名。在这里，您将GitHub上的First Contribution存储库的内容复制到计算机。

创建一个分支

更改计算机上的存储库目录（如果您还没有）：

 cd FirstContribution

现在使用git checkout命令创建一个分支：

 git checkout -b <add-your-new-branch-name>

例如：

 git checkout -b add-alonzo-church

（分支的名称不需要在其中添加单词，但要包括一个合理的事情，因为该分支的目的是将您的名称添加到列表中。）

进行必要的更改并进行这些更改

现在，在文本编辑器中打开Contributors.md文件，将您的名称添加到其中。现在，保存文件。

如果您转到项目目录并执行命令git status ，则会看到有更改。

将这些更改添加到您刚刚使用git add命令创建的分支：

 git add Contributors.md

现在使用git commit命令提交这些更改：

 git commit -m "Add <your-name> to Contributors list"

用您的名字替换<your-name> 。

将更改推向github

使用命令git push推动更改：

 git push origin <add-your-branch-name>

用您之前创建的分支的名称替换<add-your-branch-name> 。

提交您的更改以进行审查

如果您在GitHub上转到存储库，则会看到一个Compare & pull request按钮。单击该按钮。

现在提交拉动请求。

很快，我将将您的所有更改合并到该项目的主分支中。合并更改后，您将收到一封通知电子邮件。

从这里去哪里？

恭喜！您刚刚完成了标准叉 - >克隆 - >编辑 - > PR工作流，您经常会遇到作为贡献者的！

您可以加入我们的Slack团队，以防您需要任何帮助或有任何疑问加入Slack Team。