善举的力量V
26-11-14 13:04 微博认证:历史博主

一篇文档有没有用,先看动词后面塞不塞得进「被僵尸」。能塞「被僵尸」的句子就是被动语态,读起来多绕一道弯:「一个错误被返回了」拗口,「API 返回了一个错误」就顺。

被动不是不能写,执行者不重要的时候用没问题,但要是拿它当默认写法,用户就得多费脑力。文档多半是被扫的,不是被逐字读的,所以还有几个数:一句别超25个词,一段两到四句,一句只讲一件事。

拿三句出来数一数,看几句能塞进僵尸。

发布于 江苏