update pull-request draft

This commit is contained in:
Jerry Lee
2014-08-31 03:01:31 +08:00
parent ccd24343eb
commit f586b42a9b
3 changed files with 45 additions and 0 deletions

View File

@@ -21,6 +21,51 @@
这样做会变得杂乱,尤其还要涉及后面的几个提交时。
`Pull Requests`把所有相关功能整合到一个和`Bitbucket`仓库界面集成的用户友好`Web`界面中。
### 解析`Pull Request`
当要发起一个`Pull Request`,你所要做的就是请求(`Request`)另一个开发者(比如项目的维护者)
`pull`你仓库中一个分支到他的仓库中。这意味着你要提供4个信息以发起`Pull Request`
源仓库、源分支、目的仓库、目的分支。
![](images/pull-request-anatomy.png)
这几值多数`Bitbucket`会设置合适的缺省值。但取决你用的协作工作流,你的团队可能会指定不同的值。
上图显示了一个`Pull Request`请求合并一个功能分支到正式的`master`分支上,但可以有多种不同的`Pull Request`用法。
:beer: 工作方式
---------------------
`Pull Request`和[功能分支工作流](workflow-feature-branch.md)、[`Gitflow`工作流](workflow-gitflow.md)或[`Forking`工作流](workflow-forking.md)一起使用。
但一个`Pull Request`需求要么分支不同要么仓库不同,所以不能用于[集中式工作流](workflow-centralized.md)。
在不同的工作流中使用`Pull Request`会稍许不同,但基本的过程是这样的:
1. 开发者在本地仓库中新建一个专门的分支开发功能。
1. 开发者`push`分支修改到公开的`Bitbucket`仓库中。
1. 开发者通过`Bitbucket`发起一个`Pull Request`
1. 团队的其它成员`review` `code`,讨论并修改。
1. 项目维护者合并功能到官方仓库中并关闭`Pull Request`
本方后面内容说明,`Pull Request`如何在不同协作工作流应用。
### 在功能分支工作流中使用`Pull Request`
功能分支工作流用一个共享的`Bitbucket`仓库来管理协作,开发者在专门的分支上开发功能。
但不是合并到`master`分支上,而是在合并到主代码库之前开发者应该开一个`Pull Request`发起功能的讨论。
![](images/pull-request-feature-branch.png)
功能分支工作流只有一个公有的仓库,所以`Pull Request`的目的仓库和源仓库总是同一个。
通常开发者会指定他的功能分支作为源分支,`master`分支作为目的分支。
收到`Pull Request`后,项目维护者要决定如何做。如果功能没问题,就简单地合并到`master`分支,关闭`Pull Request`
但如果提交的变更有问题,他可以在`Pull Request`中反馈。之后新加的提交也会评论之后接着显示出来。
在功能还没有完全开发完的时候,也可能发起一个`Pull Request`
比如开发者在实现某个需求时碰到了麻烦,他可以发一个包含正在进行中工作的`Pull Request`
其它的开发者可以在`Pull Request`提供建议,或者甚至直接添加提交来解决问题。
### 在`Gitflow`工作流中使用`Pull Request`
-----------------