产品文档写给未来的自己

项目结束时，团队常被要求补一份文档。结果写出来的东西要么是功能截图合集，要么是给客户看的说明书，半年后自己都看不懂当初为什么这么设计。

三类文档，三个读者

决策记录：写给未来的团队，说明为什么选这个方案、放弃了什么。

操作说明：写给使用者，步骤清晰，配图和常见问题。

接口与数据结构：写给开发，字段含义、取值范围、变更历史。

怎么写才会被看

一页纸原则：每个主题尽量控制在一屏内，超长的文档没人读完。

写清日期和作者，三个月后能知道该找谁确认。

把文档放在代码仓库或项目空间里，而不是某个人的电脑上。

判断文档有没有价值很简单：新人接手时，能不能只靠它把事情做下去。