祖师爷Linus被内核维护者整烦了，别再被be被be被be噢噢！

OSC开源社区 · 公众号 · 程序员 · 2024-10-10 16:16

正文

↑点击上方蓝字关注「OSC开源社区」

Linus Torvalds 近日在发布 Linux 6.12-rc2 内核时，在邮件中写了一篇“小作文”，主要是对内核维护者所提交的 PR 描述提出了“指导意见”。

他希望内核维护者在描述 PR 中的变更时避免使用被动语态，应当使用主动语态——并且最好直接使用祈使句 (Imperative)。

我希望自己合并的 commit 信息保持一定的“统一性”，所以我经常编辑 Pull Request 的语言，使其符合更标准的布局和语言。
这不是很大的问题，通常只是留白而已，这样我们就不会有 15 种不同的缩进模式和项目符号语法。
反正我一般都是在阅读文本的时候做的，所以也不会给我带来额外的工作。
但是，当一些维护者使用被动语态时，我会尝试主动重写注释，而这会增加额外的工作量。
因此我会要求维护者使用主动语态，最好是祈使句。
换一种说法：
如果大家能避免将描述写成 “In this pull request, the Xyzzy driver error handling was fixed to avoid a NULL pointer dereference”，我会非常高兴。
可以写成 “This fixes a NULL pointer dereference in ..”；
或者，如果希望列出要点，则可以直接写成 “Fix NULL pointer dereference in ..”。
我知道这不是什么大问题。但上周我碰巧试着重写了几个这样的案例，我觉得简洁明了的语言更好。
比如用祈使句语法的 “Fix X” 就已经很清楚了。