讨论代码时不要说“it”

我在与同事讨论技术问题时注意到了这一点。 普通英语似乎不合适。

语言已经发展了数千年&＃xff0c;以与人们最相关的方式促进人们之间的信息交流。 这样做的副作用是&＃xff0c;语言已针对与以下相对简单的场景有关的信息进行了优化&＃xff1a;

• 人与其他人或动物的互动
• 人与无生命物体的互动

然而&＃xff0c;在过去的几十年中&＃xff0c;智能机器和自动化的出现意味着第三种交互已变得越来越普遍&＃xff0c;即&＃xff1a;

• 无生命对象与其他无生命对象的交互

事实证明&＃xff0c;英语&＃xff08;甚至可能是其他所有人类语言&＃xff09;的标准口头表达形式在讨论这类复杂的非生命对象间交互方面并不是很好。

例如&＃xff0c;采用以下句子&＃xff0c;它引用了人与物之间的相互作用&＃xff1a;

“约翰碰到一个路标&＃xff0c;它已经损坏了”

在这种情况下&＃xff0c;我们知道“它”是指一个对象&＃xff0c;因此这句话很清楚。 这是被破坏的路标。

但是&＃xff0c;这句话不太清楚&＃xff1a;

“汽车驶入路标&＃xff0c;损坏了”

在这种情况下&＃xff0c;我们不知道是汽车还是路标损坏了。

在讨论代码时&＃xff0c;大多数情况下&＃xff0c;我们都描述了一个或多个无生命对象之间的相互作用&＃xff0c;因此在句子中使用“ it”之类的文章通常是个坏主意。

例如&＃xff1a;

“父进程向其子​​进程发送了一条消息&＃xff0c;然后遇到错误”

在这种情况下&＃xff0c;我们不知道错误的实际触发位置。 在父进程还是子进程上&＃xff1f;

句子中涉及的对象越多&＃xff0c;诸如“ it”之类的文章词就变得越混乱。 在讨论代码时&＃xff0c;我们不应该害怕重复句子的主题多次。 同样&＃xff0c;当他们描述多个对象之间的复杂交互时&＃xff0c;我们应该毫不犹豫地打断同事&＃xff0c;问诸如“您的意思是什么”之类的问题。

From: https://hackernoon.com/dont-say-it-when-discussing-code-d673b6b5216d