使用 GitHub Desktop 为项目做贡献的初学者指南
提升编程技能的最佳方法之一就是参与开源项目协作。第一次参与开源项目可能会让人感到畏惧,我自己也非常害怕。我以为自己不够优秀,无法向大型项目提交代码,但我在这里想告诉大家,不要担心这些事情,不要害怕为大型项目做一点小改动并提交拉取请求,因为它很可能会对别人有所帮助。
寻找项目
第一步是找到一个项目。只需在 GitHub 的搜索栏中输入label:beginner
、label:easy
或label:starter
,label:first-timers-only
就会出现该项目开发者认为适合初学者程序员的问题。找到你喜欢的项目后,就可以开始你作为开源开发者的新生活了。
创建一个存储库(又称复制)
Fork
第二步是 fork 仓库。点击项目 GitHub 页面右上角的按钮即可。
现在,您拥有了该项目的个人副本,您可以对其进行编辑,而无需更改任何其他人的工作。
克隆存储库(即将副本下载到您的机器)
在此步骤中,您需要安装GitHub 桌面应用程序(在本教程中,我们将使用 GitHub 桌面应用程序,但每个开发人员都应该具备任何版本控制系统的知识)。打开您的 GitHub 桌面应用程序,然后点击 ,File
然后点击Clone repository
。您将看到 GitHub 上的存储库和分支列表。选择分支的存储库,然后点击Clone
。
现在您有该项目的本地副本。
创建新分支
每个仓库都有一个默认分支。当你提交时,会获得指向你上次提交的 master 分支。当你拥有自己的分支时,你可以在不影响 master 分支的情况下进行更改。点击Current branch
,点击New
,并为你的分支命名。 然后创建一个分支。
是时候做点工作了
要使用您常用的代码编辑器打开要编辑的文件,请在计算机上找到您的项目。克隆的默认目录(对于 Windows)应该是C:\\Users\(username)\Documents\GitHub
。现在,您可以开始对其进行更改了。
提交你的更改
完成编辑后,您应该将更改分组到一次提交中并发送到 GitHub,然后提交它们以与主项目合并。打开 GitHub 桌面应用程序,您将看到 Git 已记录所有已保存的更改。要提交,您必须在提交消息中输入提交消息Summary field
并添加描述。然后点击按钮提交更改。
推送你的更改
下一步是将本地更改与 GitHub 上的仓库同步。您需要将更改推送到 GitHub。点击显示的Publish branch
同步更改按钮。现在,您的计算机和 GitHub 上都有此分支的相同副本。
提交你的 PR
下一步是提交你的拉取请求。拉取请求会通知项目维护者你有一些工作需要他们审核,并最终添加到项目中。
转到 GitHub 上您的 fork 的主页面,然后单击突出显示的 PR 消息,其中有一个绿色按钮显示Compare & pull request
。
写一个标题,并在评论区总结你所做的工作。例如,可以这样写:“这是我的第一个拉取请求。如果你有任何反馈,请告诉我。”Create pull request
并勾选 复选框Allow edits from maintainers
。
最后一步是耐心等待修改。记住,可能需要一段时间才会有人审核你的工作。之后,你可能永远得不到任何回复,甚至可能得到负面评价。之后,你可以尝试另一个问题,另一个项目。一旦你的工作获得批准,它就会被合并!你成功了!现在,你已经具备了为网络上的开源项目做出贡献的技能。恭喜!
文章来源:https://dev.to/highflyer910/the-beginners-guide-to-contributing-to-projects-with-githubdesktop-46o3