26 | 写好产品文档的诀窍
邱岳
“产品文档是产品经理交出的第一个产品。” —— 邱岳
我们之前的两次分享，聊到了产品文档以及图例的类型和作用，当时我说文档也是产品经理设计出来的一种“产品”，所以做好产品文档的诀窍其实跟做好产品的诀窍一脉相承，也讲究用户、场景、目的和体验。接下来我就结合自己的经验，跟你分享写好一份产品文档的诀窍。
1. 明确受众、目的和形式
第一次写产品文档的时候，我拿来文档模板就开始照葫芦画瓢，模板上有什么就写什么，好像只要把模板中所有的空位填满就能写出好文档了。
其实不然，好的产品文档应该有非常强的针对性。就像做产品要先明确用户一样，写产品文档的第一步就是要明确文章的目标受众是谁。知道谁是文档的主要受众或者读者，结合他们的思考维度，才能知道该用什么样的语言、逻辑和形式。
之后，我们是要清楚每个文档的目的，而不是把写文档本身当做目的。去设想一个文档的读者在读之前的状态和读完之后的状态，你希望他能获得什么信息，做出什么决定，以及有些什么后续的动作。
弄清楚受众和目的之后，你就可以判断用什么形式来呈现文档，是静态的产品原型，动态的 Demo，一张流程图，幻灯片还是一篇 PDF 或一封邮件，大概是什么长度等等。
比如 BRD 通常面向管理层和业务部门，目的一般是要获得支持和授权，申请到足够的资源，那就应该避免说产品实现细节，不要用技术的语言，而是从潜在的市场机会和风险解释要做什么，文档的形式可能是幻灯片。
幻灯片也分阅读型和演讲型的，阅读型要把逻辑写下来，演讲型则写提纲或放图，通常要准备两份，因为很多时候是既要做演讲，也有时候是发邮件的。
而 PRD 通常是面向工程师，让他们知道要做什么，以及为什么做，进而驱动他们设计和实现具体功能。PRD 通常是写成文档，PDF 或者写在 Wiki 上（建议不要用 Word，很多工程师如果不用 Windows 系统，排版会失控），工程师不喜欢长篇大论，最好能图文并茂，如果有机会能给现场给他们讲解一下，就更好了。
公开
同步至部落
取消
完成
0/2000
荧光笔
直线
曲线笔记
复制
AI
- 深入了解
- 翻译
- 解释
- 总结
仅可试看部分内容，如需阅读全部内容，请付费购买文章所属专栏
《邱岳的产品手记》，新⼈⾸单¥59
《邱岳的产品手记》，新⼈⾸单¥59
立即购买
© 版权归极客邦科技所有，未经许可不得传播售卖。 页面已增加防盗追踪，如有侵权极客邦将依法追究其法律责任。
登录 后留言
全部留言(15)
- 最新
- 精选
张伟对二爷写过的文档好奇,二爷可否附件一版与大家共享。作者回复: 写文章的时候找来着，但因为都涉及到各种公司信息，很难脱敏。
20
嵩松这和律师写复杂一点的协议有很多共通之处，我也很希望留一个晚上发酵一下，但很多时候时间不允许，上个厕所再回来也有效果。写这种协议是成长最快的时候。作者回复: 专业！
8
魔幻的季节学习了二爷三篇如何写好文档，现实中我有这样的困惑。FSD是需要怎样的颗粒度，如果需要做到数据库设计和接口定义，我在新团队做一些功能优化升级时往往需要大量阅读之前的系统设计，在文档不全的队伍中甚至需要找IT负责人才可以解决，否则往往写了也是无法被执行。但整个过程效率是非常低的。请问这种情况下，有更好的解决方案吗。作者回复: 并不是所有文档都需要粒度很细，因为产品文档很难被持续维护，在你说的这种情况下，了解遗留系统最好的方法恐怕就是找开发同事帮忙看代码，或者自己去看代码了。
1
靡小泡二爷已经第三次提到媳妇了，这说明做产品，有一个媳妇是多么重要🤔160
听天由己现在都在强调产品能力，把每一件事情都要当作产品去思考与运作，这种思维方式本质上还是共情能力，我们有时很难跳出自己的框架去交流沟通，习惯于站在批判者的角度去讨论其他产品利弊，却忽略了自己的呈现方式。 入行至今也十几万字的产品文档，现在其实还是不够细致，在评审会议后，梳理与统一容易遗漏。就像自己的工作那样，如果不注意总结或是改进，我们很难有真正的进步。12
牧羊犬待了几家创业小公司，好像产品经理都没有写文档（单独的需求文档）的习惯，而只是将所有需要注意的内容都备注在原型上，一般开发也就直接根据原型图来开发，大公司的需求文档都是单独写的吗？不太清楚其他公司的一些项目流程10
Dylan总结了一下文章要点: 1. 先明确受众与需求，定展现形式 1. 去设想一个文档的读者在读之前的状态和读完之后的状态，你希望他能获得什么信息，做出什么决定，以及有些什么后续的动作 2. 多交代“为什么” 3. 不断拆解流程和异常情况 1. 细致的用例+异常情况 4. 先写厚，再写薄 5. 冷静期发酵7
张星彩可以分享一个需求文档么，如果设计公司敏感信息，可以删减掉，超想看下5
空空二爷为什么不举个模板例子呢，这样会好理解很多。通偏光这样两，其实很不形象。比如atm机那个例子，用个脑图也好啊。有个您之前做个的产品文档模板就更好了，敏感信息可以删掉或者打马赛克。希望可以得到反馈，谢谢二爷。3
三林创业小公司业务调整快，人员也少。文档没有成文，需求的表现是sketch和思维导图2
收起评论