WEB组工具使用规范

公共文档

1. Git

1.1 修改提交用户名和Email

正确配置自己的姓名和和公司邮箱，user.name用拼音全拼，邮箱用公司邮箱

git config --global user.name "Your Name"
git config --global user.email you@example.com

1.2 规范commit信息

• 用一空行分隔标题与正文。
• 标题使用大写字母。
• 标题不超过50个字符。
• 标题使用祈使语气。
• 标题不要使用句号结尾。
• 正文在72个字符处换行。
• 正文解释是什么和为什么，而不是如何做。

示例

新增导入功能，修改用户姓名和用户密码长度等
* [add] 用户管理增加导入功能  
* [modify] 将用户姓名最大长度改为20字符
* [modify] 将用户密码最大长度改为20字符
* [remove] 移除自定义数据项模块
* [remove] 移除用户管理的导入功能按钮
* [bug-1003] 新增时存在xxxx问题                      //对应禅道上的bug号
* [bug] 修改用户时xxxx问题                          //开发人员自己发现的bu

1.3 tag使用规范

git tag主要用于标识提测版本号，每次提测后，都应该新增一个tag，对应提测版本号。下面列出显示的git tag操作，详细的可以查看git相关说明。

• 列出所有标签

$ git tag
v0.1
v1.3

• 查找标签

$ git tag -l 'v1.4.2.*'
v1.4.2.1
v1.4.2.2
v1.4.2.3
v1.4.2.4

• 新增标签

$ git tag -a v1.4 -m '关于当前版本的说明'    // v1.4即版本号

• 显示标签

$ git show v1.4
tag v1.4
Tagger: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Feb 9 14:45:11 2009 -0800
关于当前版本的说明
commit 15027957951b64cf874c3557a0f3547bd83b3ff6
Merge: 4a447f7... a6b4c97...
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sun Feb 8 19:02:46 2009 -0800
    Merge branch 'experiment'