查看原文
其他

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

开源中国 OSC开源社区
2024-10-25
↑点击上方蓝字关注「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” 就已经很清楚了

虽然 Linus 此次的建议与内核代码并无直接联系,或许还会有人觉得他管得太多了。

不过小编作为常年浏览大量英文内容的人,这次强烈支持祖师爷的观点,因为这种被动语态确实太烦人了。


对了,如果你不知道本文封面图的含义,请欣赏下面歌曲:


相关来源

https://lore.kernel.org/lkml/CAHk-=wgMS-TBfirwuxf+oFA3cTMWVLik=w+mA5KdT9dAvcvhTA@mail.gmail.com/


延伸阅读
Linus Torvalds:你的代码好恶心
Linus言辞激烈,怒怼谷歌内核贡献者:垃圾代码!

Linus:圣诞夜我不看代码,明年再发布新版

END


热门文章

Rust非常安全编程语言,使Android漏洞大幅下降
高通拟收购英特尔——Arm与x86之争到此为止?“革命性”「Safe C++」扩展提案:质疑Rust、理解Rust、成为Rust?
我有一个大胆的想法:呼吁Linus延迟退休!Zen浏览器——号称是“开源版Arc”、轻如鸿毛、快如闪电

分享、在看与点赞 Orz
继续滑动看下一个
OSC开源社区
向上滑动看下一个

您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存