Linus Torvalds 要求内核开发人员编写更好的 Git 合并提交信息

摘要:

昨天在宣布 Linux 6.12-rc2 内核时,Linus Torvalds 要求内核维护者在提交信息方面做得更好。Torvalds 尤其希望内核维护者在描述拉取请求中的变更时,能更好地使用积极、命令式的语气。

Linux创建者在6.12-rc2 公告中解释道:

总之,说到一个完全不同的话题:我试图让我的合并提交信息具有一定的"凝聚力",因此我经常编辑拉取请求的语言,使其符合更标准的布局和语言。 这不是什么大不了的事,通常只是留白而已,这样我们就不会有 15 种不同的缩进模式和项目符号语法。

但是,如果有些维护者使用被动语态,我就会主动重写解释(当然,有时我也会觉得自己并不关心如何让信息听起来一致)。

因此,我希望维护者能使用主动语态,最好只是命令式。

换一种说法:

而不是写成"这修复了...中的 NULL 指针解除引用......",或者特别是如果你只是列出了要点,那么就把要点写成"修复......中的 NULL 指针解除引用"。

我知道这不是什么大问题。 但上周我碰巧尝试重写了几个这样的案例,我觉得简单明了的语言更好。

这对合并提交消息的连贯性会有很大帮助,因为目前合并提交消息的质量可能会有很大差异,尤其是在 Linux 内核合并窗口期间,所有新功能代码都会出现在拉取请求中,但在周期后期的修复拉取请求中,摘要的质量也会有很大差异。

相关文章:

对Bcachefs的修复拉扯让Linus Torvalds感到沮丧

我们在FebBox(https://www.febbox.com/cnbeta) 开通了新的频道,更好阅读体验,更及时更新提醒,欢迎前来阅览和打赏。
查看评论
created by ceallan