代码提交日志规范

1. 提交注释要求

代码提交必须写日志信息。

2. 基本理念

日志信息内容要简明扼要,说明为什么做这个修改/提交代码。

就如同给另一个开发人员交谈一样,说清楚为什么要修改,以及其他需要给对方澄清的内容。

该说明的要点一定要写,但也不要长篇大论。

3. 格式要求

  • 针对redmine上某个开发特性或问题提交的代码

svn ci -m "commit description. (#1234)" ...

日志信息中最后的"#1234" 是必须包含的,用于与redmine上的任务单关联。(注意“#”要用英文字符的)

每次代码提交只应该与一个redmine单相关。

  • 对于没有相关redmine单的代码提交

svn ci -m "simple commit description." ...

注意:此种场景仅限于非常小的代码调整,大的代码修改应在Redmine上增加任务单以便跟踪。

posted @ 2012-09-19 19:29  luojunqiang  阅读(645)  评论(0编辑  收藏  举报