我是一个程序员。当涉及比较大的技术决策时,我们会组织一波人到会议室,让人讲技术方案,其他人提意见。

经常会出现的一个情况是,对于一个稍复杂的方案,大家经常会聊很久却无法达成一致。原因经常有这些:

  • 术语的理解没有达成一致
  • 有些人缺乏对背景的理解
  • 方案作者没有做出易懂的材料

这个时候白板会是非常方便的工具。在白板上比划比划,往往对理解起到很大帮助。但我认为:应该扔掉白板。因为:

  • 大多数需求,没有复杂到需要用白板才能讲清楚
  • 如果需要用白板,说明方案作者的材料准备不足,没法让与会者能很快理解
  • 大多数技术问题,在你理清要求和约束后,方案就像是数学推理一样简单,没有一定要用白板才能讲清楚的
  • 用白板讨论出来的结论,往往不会落到文档中,不利于知识的传承

事实上,在我工作过的、市值曾经全球前十的大厂,也经常会有这样的情况:什么文档也不准备,大家就开始在白板上边画边聊事情。看起来像是节省了时间,但是实际上沟通的效率和质量却是很差的。

扔掉白板背后的意义是,应该 写好文档

  • 写文档的过程中,你不得不全面细致地梳理思路
  • 好的文档可以 形成杠杆,每个人都可以阅读并理解,节省沟通成本

但令人难过的是,我工作已经 8 年,周围写好文档的人少之又少。语病、缺乏逻辑、排版混乱,都是常见的情况。在 GitHub 上看项目时,感受到国人的项目文档较差,但老外的文档会比较好。在虾厂工作时,也能感受到新加坡同事的文档较好。这究竟是为什么?