仔细检查你写的每条评论。一个简单的语义错误就有可能会给他人带来不必要的麻烦和理解成本。

一个混淆语义的例子：

类和函数的逻辑看上去没什么问题，但我建议修改下它的名称以更好的反应它所代表的功能和逻辑。

需要更改的是什么，类还是函数？究竟指哪个？为什么一个忙碌的同伴必须要通过询问你，以搞清楚你评论的真正意图？

另外，请注意明确指出你正在讨论的确切的代码所在行。