本文目的:
新手gitter想参与开源项目,首次进行PR经常会遇到以下几个问题,:
-
想要参与到开源项目中,却不知道该如何提交代码给管理者.
-
网上搜了各种方法,都是告诉我要进行pull request,怎么进行pull request,但是没有操作环境.
-
提交了pull request却没有收到管理者的回复,怀疑是不是自己流程不对。
本文提供自己搭建的测试git项目环境,帮助新手首次进行PR提交,完成整个任务流程。
https://github.com/testPRGit/testPR是我自己搭建的一个测试PR的项目,新手可以参考后面的流程,提交自己的PR请求到
https://github.com/testPRGit/testPR项目中来,我会及时的进行回复,把提交的PR合并到这个项目中来,帮助大家顺利走完PR流程。如过程中有问题,欢迎在下方留言。
术语定义:
-
源项目(希望参与到的开源项目): https://github.com/testPRGit/testPR
-
分支项目(将源项目fork到自己的repository仓库中,自己仓库中的称为分支项目)
具体流程:
1、fork源项目到自己的repository仓库中
找到源项目(
testPRGit/testPR),点击右上角的Fork,等以小会儿,就能在自己的repository看见fork后的项目,比如我的是(
bjtudujunlin/testPR.git)
2、clone自己fork到repository中的项目到本地
git clone
https://github.com/bjtudujunlin/testPR.git ,这里用任何git客户端都可以,改成你自己fork出来的分支项目
3、本地修改并push到自己的repository中
git add .
git commit -m '新增测试文件'
git push
提交后,repository会显示提交的更新
4、发起pull request请求
发起pr请求,将分支项目所做的改变发送给源项目的管理者,请求merge到源项目指定的版本中
a、找到分支项目,点击“New pull request”按钮
b、对pull request更新内容进行review,然后点击“Create pull request”
如下图所示,1部分是要合并的分支,2部分是分支项目相对于源项目做了哪些变更,如果确认没有问题,那么点击“Create pull request”
c、填写merge说明
更新说明,描述为什么药提交这个merge,解决了源项目的什么bug,一般开源项目都会对pr内容的说明。填完以后点击“Create pull request”即可
d、提交pr请求后,在源项目的pull request里面就能看见你刚才提交的请求,到这一步后,就等源项目管理者那边处理
如果管理者有问题会在上面的源项目pull request里面对你进行回复,如下【ps,提交的时候最后@管理者,这样他们可以收到git的消息通知】
如果管理者接收你提交的内容,并进行了merge,git会通过消息通知你改提交已经进行了merge,如下图:
在你主页的下方,就能看见做的共享