Linus Torvalds 向“被动语态”宣战
在日前宣布推出 Linux 6.12-rc2 的公告中,Linus Torvalds 对内核维护者 commit 信息的英文语法也提出了更多要求。
他希望,内核维护者在描述拉取请求中的变更时能够避免使用被动语态,更多的使用主动语态、命令式语气。
我试图让我的合并 commit 信息具有一定的“凝聚力”,所以我经常编辑拉取请求的语言,以匹配更标准的布局和语言。这不是什么大不了的事,通常只是与 whitespace 有关,这样我们就不会有 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”就已经很清楚了。
更多详情可查看邮件列表。

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
HServer 3.5.M7 已经发布,高性能 Webserver
HServer 3.5.M7 已经发布,高性能 Webserver。 此版本更新内容包括: 1.对jar包类加载器优化 2.对maven打包优化 3.对加载器进行相关插件适配 4.打包支持打胖包和散包 5.打包支持Aes打包加密 打包模块 加密模式情况 参数设置密码启动:java -Dpassword= dm_pro_token_key -jar xxx.jar 命令行提示输入密码 <build> <!-- 默认项目名 --> <finalName>aaa</finalName> <plugins> <plugin> <artifactId>hserver-plugin-maven</artifactId> <groupId>cn.hserver</groupId> <executions> <execution> <configuration> <!-- 默认胖包 --> <fatJar...
- 下一篇
从小立志改变农业,后来写代码、玩开源、开酒馆······
为了迎接 1024 程序员节,OSChina 开源中国新增了【家里有个程序员】栏目,记录一下 OSCer 们当前的生活,欢迎各位 OSCer 踊跃投稿呀。 投稿细则:https://my.oschina.net/u/3859945/blog/15727245 说起程序员,大家的第一印象估计是:沉默寡言,生活全是代码与 bug 的较量。但如果有人问我:“为什么要做程序员?” 我只能说,血液里仿佛流淌着一股未完成的使命感。这事儿,要从我初中开始说起。 小时候,我立志“走出大山,再回到大山”。学技术、改造家乡,打造一个农业的良性生态循环。这份使命感,既单纯又朴素。而随着岁月的流逝,生活给我做了个“热更新”。上了大学,看完《社交网络》电影后,感觉有了新的使命,决定让校园告别纸质传单和黑板报,直接上手写代码,目标:改变校园社交!于是我的“Hello, world!”就这么拉开了序幕。我从想改变农业的少年,变成了想改变校园社交媒体的青年。 大学毕业后,我踏上了程序员这条不归路。当时刚进前端领域,老板一句“不破则不立”,就把我推向了 Java 的大门。一学就是七八年,硬是从前端熬成了全栈开发。外表平...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- Docker使用Oracle官方镜像安装(12C,18C,19C)
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果
- SpringBoot2全家桶,快速入门学习开发网站教程
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- MySQL8.0.19开启GTID主从同步CentOS8
- Springboot2将连接池hikari替换为druid,体验最强大的数据库连接池
- CentOS8编译安装MySQL8.0.19
- SpringBoot2初体验,简单认识spring boot2并且搭建基础工程
- CentOS7编译安装Cmake3.16.3,解决mysql等软件编译问题
- Linux系统CentOS6、CentOS7手动修改IP地址