Elvis' Blog

代序

2005年我遇到了两个大转折：由媒体转入互联网行业，及重新定位到互联网产品管理方向——那时，我被灌输了一个概念：“做产品，就要写文档”。迄今为止，我已经写过至少600页的文档。

从迷信文档的超凡意义，到对文档的深恶痛绝，再到蜻蜓点水似的提纲与附注……我一直在寻找某种是真正有效、具有成长性且令人愉悦的文档——不仅是阅读者，撰写者也应该是愉悦的——我称其为“有效文档（The Effective Document）”。

这个《有效文档》系列将是对个人文档经验的一个总结，欢迎大家讨论，一起找到文档的青鸟。

-=-=-=-=-=-=-=-=-=-=-=-=- 回到正题的分割线 -=-=-=-=-=-=-=-=-=-=-=-=-

在撰写文档之前，首先要回答一个问题：为什么要写文档？

“有效文档”有三项核心作用：沟通基础、思想表现和工作成果。

作为沟通基础的文档

通常项目可以分为三段：意向→沟通→实现。在“意向”阶段通常只能包含方向性的内容，即做或不做。而具体到实际操作环节中，面对“怎么做”时，仅是口述或简单的图例可能不足以准确的传达信息。此时就需要文档以进行进一步的说明（甚至是限制），以达到充分沟通的目的。

请注意：文档可以作为沟通的基础（或契机），但不等于是沟通本身。

作为思想表现的文档

文档是你表述思想的第一表现——你既不能要求别人记住你说的每一句话，而且你自己也很难完全记起原来说过的话——文档就像一张“思想快照”，可以让对方与自己共同想起“那个到底是什么”。

请注意：当你的文档没有表现出清晰的逻辑时，别人也会认为你的思想是混乱的。

作为工作成果的文档

很多时候的很多工作并不是像开发、设计一样，有某种具体的东西可以用到或可以看到，所以我们有时会以文档当作阶段性*的工作成果。（*注：文档通常存在于过程中，具有明显的时效特征。）某些文档的形成可以看做是项目里程碑，如工作计划、产品需求、项目总结、竞争对手分析报告等。

请注意：永远不要把写文档当作你的工作目标，除非你的全部工作就是撰写文档。