技术

IT这个行当之需求与时间管理 golang结构体和包中的类型或基础类型定义方法 golang中结构体的初始化方法(new方法) 项目管理总结 python函数式编程之-装饰器(Decorators) python文件批量处理 Go,互联网时代的C Python推导式演变(Comprehensions) 项目管理感悟 golang学习简单例子 了解GitHub工作流【译】 PHP Socket的使用 Apache 日志文件格式及简单处理 Python脚本--下载合并SAE日志 PHP命名空间及自动加载 基于CSS3实现尖角面包屑 部署Ceilometer到已有环境中 OpenStack Ceilometer Collector代码解读 OpenStack Ceilometer数据存储与API源码解析 OpenStack Ceilometer中的Pipeline机制 OpenStack Ceilometer Compute Agent源码解读 学习Python动态扩展包stevedore 学习Python的ABC模块 Python包管理工具setuptools详解 OpenStack Horizon 中文本地化 WSGI学习 在虚拟机单机部署OpenStack Grizzly 学习使用python打包工具distutils python包工具之间的关系 给OpenStack创建Ubuntu镜像 OpenStack Grizzly Multihost部署文档 为什么使用pip而不是easy_install HTML中meta标签viewpoint的作用 交互式编程-IPython 页面提速之——数据缓存 给OpenStack创建Win7镜像 Ceilometer的命令行使用 部署一个ceilometer-horizon项目 给OpenStack创建Windows XP镜像 几种企业的存储系统 概念模型、逻辑模型、物理模型的区别 五中常见的开源协议整理(BSD,Apache,GPL,LGPL,MIT) OpenStack监控项目Ceilometer的一些术语 VNC和远程桌面的区别 OpenStack Ceilometer项目简介 虚拟化与云计算中KVM,Xen,Qemu的区别和联系 调试和修改OpenStack中的Horizon部分 JavaScript变量作用域 kanyun worker原理 kanyun server服务 在OpenStack中部署kanyun kanyun的api-client命令 sae下的python开发部署和一个简单例子 OpenStack Nova内部机制 PHP可变变量 JS中防止浏览器屏蔽window.open PHP操作Session的原理及提升安全性时的一个问题

标签


了解GitHub工作流【译】

2014年01月30日

GitHub流是一个轻量级,基于分支的工作流,它使得小组和项目的部署变得标准化。这个向导解释了GitHub流是如何&为什么工作的。

github-flow

创建一个分支

当你工作在一个项目中,你可能会在任何时间产生不同的想法和特性计划--这些都是准备完成的,或者其他不准备完成的。分支的存在可以帮助你管理工作流。

当你在自己的项目中创建一个分支的时候,也就等于创建了一个尝试自己想法的环境。你在这个分支修改的东西不会影响到主分支,所以你可以尽情的测试和提交改变。这些改变直到你的合作伙伴审查过,确保安全才会被合并到主分支中。

分支是Git的一个核心概念,并且GitHub流完全基于这个概念。只有一个规则,那就是master分支必须是可部署的。

因此,当你在修复bug或者创建新功能时,你的新分支必须创建在master之外。你的分支名称应该是自描述的(如:refactor-authenticationuser-content-cache-keymake-retina-avatars),所以其他人可以了解什么正在进行。

增加提交

一但你的分支创建完成,就可以进行修改了。不管你进行了增加、修改或者删除一个文件,你都可以进行提交代码,将他们增加到分支中去。这个过程可以保持跟踪你对一个特性分支工作的发展。

提交同样为你的项目创建了一个清晰的历史,这样别人就可以了解你做这些的原因以及内容。每一个提交有一个相关的描述,这个描述可以解释你具体做了什么修改。另外,每一个提交都应该是分开的修改单元。这个使得你可以在发现bug的时候回滚修改,或者你决定朝向不同的方向。

提交描述是非常重要的,尤其因为Git跟踪你的改变并且在他们被推送到服务器上的时候显示他们。通过写出清楚的提交描述,你可以使得别人容易遵从和提供反馈。

开启一个Pull Request

Pull Request最初开始于对你的提交的讨论。因为他们紧密集成在Git库下,如果你的请求被接受,所有人可以看到被合并的改变具体包含什么。

你可以开启一个Pull Request在开发过程工任何部分:当你有少量代码,或者你希望分享一些截图或平常的想法,或者当你被卡住希望获得帮助及建议,又或者当你准备好让别人来审查你的工作。通过在请求描述中使用GitHub的 @方式 ,你可以向某一个人或者团队要求反馈,不论他们不在线或者在别的时区。

Pull Request对于开元项目的管理和分享都非常有用。如果你使用一个Fork&Pull模型,Pull Request提供了一个方式来告知项目管理者他们希望关注的改变。如果你使用Shared repository Model,Pull Request有助于开始审查和讨论即将合并到master分支的改变。

讨论并审核你的代码

一但一个Pull Request被开启,负责审核代码改变的人们或团队可能会有一些问题或者评论。可能代码风格不符合项目指导,修改缺少单元测试,或者所有修改都做的非常好。Pull Request被设计来促进和不活这种类型的会话。

在对你提交进行讨论和反馈的过程中,你可以继续推送你的分支。如果有人评论你忘了做一些事情,或者有一些bug在你的代码中,你可以在自己分支中修复并且推送这些修改。GitHub将在统一的Pull Request视图中给你显示新的提交和其他额外的反馈。

Pull Request评论用Markdown写成,所以你可以嵌入图片和表情符号,使用pre-formatted的文字块,和高亮的格式。

合并和部署

一但你的Pull Request审核通过并且分支通过测试,这些代码就可以被合并到master分支以便部署。如果你需要在合并到GitHub库前进行测试,你可以在本地先进行合并。这些在你推送到库中前都是非常容易控制的。

一但被合并,Pull Request会对你的代码保存一个历史修改记录。因为它们是可搜索的,所以所有人都可以回顾到历史纪录去了解一个决定是为什么或者怎么完成的。

通过在Pull Request的文字中包含某些关键字,你可以关联代码和issues。当你的Pull Request被合并,相关的issues同样会被关闭。比如,输入Closes #32将会关闭库中的32号issue。想要获得更多信息,点这里

原文链接:http://guides.github.com/overviews/flow/