Jimliu


一只刚上路的前端程序猿


编写良好的git commit(译)

原文地址 Writing good commit messages

好的commit信息至少有三个目的:

  • 加快代码review过程
  • 帮助我们编写好的release
  • 为了帮助Erlang / OTP的未来维护者(可能是你!),未来五年,找出为什么对代码进行特定更改或为什么添加了特定功能。

像这样构建您的提交消息:
From: http://git-scm.com/book/ch5-2.html

1
2
3
4
5
50字以内的变更摘要
如有必要,更详细的说明文字

更多的描述出现在空行之后
- Bullet points也可以

可以

  • 在命令行模式写下你已经做完的任务的总结和描述,就好像你在给某人指令。使用 ‘Fix’, ‘Add’, ‘Change’开头,而不是‘Fixed’, ‘Added’,’Changed’
  • 第二行要留白
  • 提交的信息要换行

不可以

  • 不要以句号作为行的结尾,因为这是一个title

Tips

  • 如果总结你的提交看起来很困难,可能是因为它包含了几个逻辑更改或错误修复,并且使用git add -p更好地分成几个提交。

参考

以下博客文章对commit message进行了很好的讨论:http://who-t.blogspot.com/2009/12/on-commit-messages.html

最近的文章

[转]JavaScript 如何工作:对引擎、运行时、调用堆栈的概述.

1原文地址: https://juejin.im/post/5a05b4576fb9a04519690d42#comment 随着JavaScript越来越流行,越来越多的团队广泛的把JavaScript应用到前端、后台、hybrid 应用、嵌入式等等领域。 这篇文章旨在深入挖掘JavaScript …

于  js 继续阅读
更早的文章

函数节流与函数防抖

概念函数防抖(debounce) 当调用动作过n毫秒后,才会执行该动作,若在这n毫秒内又调用此动作则将重新计算执行时间 函数节流(throttle) 预先设定一个执行周期,当调用动作的时刻大于等于执行周期则执行该动作,然后进入下一个新周期 区别 函数防抖:如果有人进电梯(触发事件),那电梯将 …

于  javascript 继续阅读