Roshanjossey
6.2 KiB
第一次做贡献
 |
GitHub Desktop Edition |
|---|
这是一个针对初次参与者的指南。
难。做任何事情的第一次总是难的。特别是在合作时，犯错并不是一件舒服的事情。但开源就是关于合作与共同工作的。我们想要简化新开源贡献者第一次学习和贡献的方式。
阅读文章和观看教程可以帮助，但实际操作而不搞砸任何事情会更好。这个项目旨在提供指导并简化新手做出他们的第一次贡献的方式。记住，你越放松，你学得就越好。如果你在寻找做出你的第一次贡献，只需跟随下面的简单步骤。我们保证这将是有趣的。
如果你的机器上没有GitHub Desktop，请安装它。
如果你使用的是GitHub Desktop 1.0之前的版本，请参考这个教程。
Fork this repository
通过点击这个页面右上角的 fork 按钮来 fork 这个repository。这将在你的账户中创建这个repository的一个副本。
Clone the repository
现在将这个repository克隆到你的机器上。
重要提示：不要克隆原始repository。去你的 fork repository然后克隆它。
要克隆repository，点击“Clone or Download”然后点击“Open in Desktop”。
克隆这个repository
一个弹出窗口将打开。点击“Open GitHubDesktop.exe”。
克隆这个repository
在你点击“Open GitHubDesktop.exe”后，内容将被下载到你的计算机上。
克隆这个repository
现在你已经将第一个贡献者仓库在github的内容复制到了你的计算机上。
Create a branch
现在通过点击顶部的“Current branch”图标然后点击“New branch”来创建一个分支：
将你的分支命名为。例如，“add-james-smith”
点击 Create branch
Make necessary changes and commit those changes
现在，转到历史标签页并通过右击然后在文本编辑器中打开Contributors.md文件。滚动到页面底部并添加你的名字，然后保存文件。
例如：如果你的名字是James Smith，它应该看起来像这样。
[James Smith](https://github.com/jamessmith)
你可以看到Contributors.md有变化，它们已经被添加到Github Desktop。
现在提交这些变化：
在summary字段中写上"Add to Contributors list"作为消息。
将替换为你的名字。
点击写着Commit to add-your-name的按钮。
在底部，你可以看到已经创建了提交。
Push changes to github
点击File->Options并登录到Github.com。输入你的Github用户名和密码。
点击右上角的Publish按钮。
推送你的变化
Submit your changes for review
如果你去你在github上的仓库，你会看到Compare & pull request按钮。点击那个按钮。
创建一个拉取请求
现在提交拉取请求。
很快我就会将所有的更改合并到这个项目的master分支中。一旦更改被合并，你将收到通知邮件。
Where to go from here?
恭喜！你刚刚完成了你会经常遇到的作为贡献者的标准fork -> clone -> edit -> PR工作流程！
庆祝你的贡献，并通过去web app与你的朋友和追随者分享。
如果你需要任何帮助或有任何问题，你可以加入我们的slack团队。