【Git】PR:让开源项目merge你的代码

前言:
本文旨在记录Git的pull request实战以及相关的技术好文的传送门(≧∇≦)
本文假定你已经有github账号,本地已经安装git。如果没有,请下拉至分割线( 30分钟入门github的传送门!(⊙o⊙)!)。

看过一篇文章,如果不擅长讲故事,那就从what 、why 、how三大法则讲起(^-^)V (什么!你有更好的讲故事套路?! 请教我(づ ̄3 ̄)づ)


what & why

Pull request是开发者使用Github进行协作的利器。
Pull Request是协作者修改代码后或在原基础上增加新代码后向仓库发送采纳的请求功能 ; 同时pull request还是一个专注于某个提议功能的讨论版,协作者可以根据code reviewer的意见再次修改并提交新的request。

awesome-vue pull request界面

how

在了解pull request的应用场景后,现在尝试在github上进行第一次的pull request。
由于最近在学习<a href="https://vuejs.org/">vue</a>,同时利用<a href="https://freecodecamp.cn/home">freecodecamp</a>的项目作为练手(毕竟自己提需求总是在徇私 W( ̄_ ̄)W ),所以把自己写好的<a href="https://github.com/CaiYiLiang/vue-demos/tree/master/wikipediaViewer-vuejs">vue小项目</a>链接提交到<a href="https://github.com/vuejs/awesome-vue">awesome-vue- Example ★11,002 </a>上面去,被尤大大的项目收录还是很激动哒(≧▽≦)/。
所以以下的对象:尤大大的awesome-vue仓库,本人(路人甲)的仓库。

Step 0:

先到Github page上对awesome-vue官方项目进行fork操作


Step0 : Fork!
Step 1:

在对awesome-vue官方项目进行fork操作后,自己的Github服务端就有了一个项目的副本,也就是可以在自己的repo中看到同名项目。


Step1:自己的Github服务端
Step 2:

把刚刚fork的Github仓库克隆到本地,这样才能在本地对项目进行修改或者更新。打开cmd或者git bash,进行git clone。
git clone https://github.com/your-github-name/your-project.git

Step 3:

现在本地已经有了项目副本,是否可以立刻对项目进行更新或者修改呢?Github很棒的地方在于让我们每个协作者都有属于自己的开发环境而不影响主项目,项目reviewer可以看到你更新的部分并且进行与现有项目的合并。
现在,我们应该创建一个属于自己的分支,在这个属于自己的分支中进行更新,这个分支将是随后发起pull request时要提交的源分支。
cd your project
创建属于自己的分支,并切换到该分支
git branch -b your-branch
查看当前所在分支
git branch

举个栗子.JPG
Step 4:

在属于自己的分支进行项目内容更新,并且把你的更新提交到你的github远程仓库中。
编辑一些代码/更新项目文件
git commit -a -m "新功能的一些草稿"
git push orgin your-branch

Step 5:

好(o)/~ 现在可以把自己的项目更新进行pull request了!可以让项目reviewer看到自己的东西并且合并到项目中去了!!
Github上已经有了自己的feature分支之后,点击项目简介下的 New Pull request 按钮,创建一个pull request。

pull request进行时

Step 6:

当点击New Pull request 按钮后,会自动跳转到官方项目的repo,
如下图,将vue/awesome-vue(<b>源仓库</b>)的master(<b>源分支</b>)合并到<b>目标仓库</b>的<b>目标分支</b>。


open a pull request.png

完成!O(∩_∩)O!


原理图镇楼
Step 7:

静静等待项目reviewer审核你的request。

First pull request
pull request Approve!!
参考Reference:
  • <a href="http://blog.xiayf.cn/2016/01/18/github-fork-pull-request/">基于Github的pull request流程做开源贡献</a>
  • <a href="http://jinlong.github.io/2015/10/12/syncing-a-fork/">如何同步 Github fork 出来的分支</a>

===================假装是分割线======================

Git 快速入门:
  • <a href="https://github.com/geeeeeeeeek/git-recipes/wiki/1.1-%E6%9E%9C%E5%A3%B3%E4%B8%AD%E7%9A%84-Git">果壳中的 Git</a>
  • <a href="http://www.jianshu.com/p/66f41a89b6b5">Github 的注册与使用教程以及github page (一)</a>
  • <a href="http://www.jianshu.com/p/cd1430161149">三十分钟学会Git</a>
  • <a href="http://www.ruanyifeng.com/blog/2015/12/git-cheat-sheet.html">常用 Git 命令清单</a>
  • <a href="http://learngitbranching.js.org/">Learn Git Branching - 动画教学</a>
  • <a href="http://www.jianshu.com/p/bfec042349ca">话说Svn与Git的区别(以后别再问我了)</a>

原创文章

简书:<a href="http://www.jianshu.com/u/c0600377679d">HelloCherry</a>
Github: <a href="https://github.com/CaiYiLiang">CaiYiLiang</a>
其它文章:<a href="http://www.jianshu.com/p/7a35fa90810f">Node.js | 更tech地解决Excel表的邮件地址</a>
vue-projects:<a href="https://github.com/CaiYiLiang/vue-demos">vue-demos</a>

如果觉得有一点点帮助,一个❤❤就是鼓励(。⌒∇⌒)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,529评论 5 475
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,015评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,409评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,385评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,387评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,466评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,880评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,528评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,727评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,528评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,602评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,302评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,873评论 3 306
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,890评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,132评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,777评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,310评论 2 342

推荐阅读更多精彩内容