代码注释更加和谐好不好?

今年 10 月,Linux 开始推行新的行为准则(Code of Conduct),旨在让代码注释变得“更具包容性”。虽然有不少人表示了支持,但也有批评者对此毫不热衷。今天,来自英特尔的 Jarkko Sakkinen 决定将之付诸于行动 —— 反对在代码评论中使用一些不和谐的词汇,并提议将某个 F 开头的单词、用“拥抱”(hug)来取代。

代码注释更加和谐好不好?代码注释更加和谐好不好?

对于这个“疯狂的变化”,有人想知道 Sakkinen 是否在开玩笑,也有人喷之为“审查过度”,并表示拒绝将这样的“补丁”应用到自己的代码中。

代码注释更加和谐好不好?代码注释更加和谐好不好?

中立人士表示,虽然并不介意这一变化,但这可能会导致一些语句变得难以理解。该观点得到了另一位荷兰伙计的认同,他认为这些“替代语”会让英语非母语的人士感到困惑。

代码注释更加和谐好不好?代码注释更加和谐好不好?

和谐后的例句包括“某些速龙笔记本电脑确实 *** 了 PST 表”(really hugged PST tables)、“如果你看不懂,请 *** 远离我的代码”(stay the hug away from my code)、以及“只有 Sun 才能把这些漂亮的部件和 *** 的编程界面结合到一块”。
虽然这些变化并不是那么地反乌托邦,但让代码注释变得晦涩难懂,显然不是一个很好的做法。

posted @ 2018-12-05 09:23  穿着衣服的大卫  阅读(137)  评论(0编辑  收藏  举报