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

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 此次的建议与内核代码并无直接联系,或许还会有人觉得他管得太多了。

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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值