需求文档的注意事项

产品需求文档(PRD)定义了产品的功能、逻辑、交互等关于产品的一切,工程师基于此进行开发,测试基于此写测试用例,它的重要性不言而喻。这里说说写 PRD 的一些建议和注意事项

1. 不要用 word、用 wiki

一些大厂的产品经理还在用 word 写需求文档,他们会在文档顶部说明修订时间、作者以及大致的更新内容,看起来很规范。确定最终版后,使用邮件或 IM 将文档发送给相关的开发、测试人员。

Word 版 PRD 的版本更新记录

使用 word 写文档有以下缺点

  1. 不支持全局搜索和即时预览。随着产品的迭代,文档越来越多,查找会越来越不方便,在邮件或 IM 中需要下载下来重新打开查看,手机端查看和修改更加麻烦。
  2. 版本管理不便。需要修改时候,修改对应的内容后需要重新发邮件给所有人,如果有很多次版本迭代,很容易就混淆究竟哪个才是最新版。
  3. 不利于离职人员交接。当一个同事要离职时,需要把所有他负责过的 word 文档整理出来交接给另一个人,如果没有处理到位,一些历史文档就丢失了。

wiki 系统中, Confluence 是不错的选择,支持全文搜索、每次保存都有记录,无需手动撰写版本记录,支持树状层级结构,权限控制也可以做到非常细致,这里强烈推荐。当然,如果你们团队使用 Teambition、Tower 等在线协作工具,可以直接使用其自带的文档管理工具。

Confluence 的版本记录功能

2. 需求文档是碎片化的,不是大而全的

我曾见过上百页的 word 版需求文档,打印出来简直就是一本书。它的缺点很明显:传递起来太过笨重,在文档内查找定位繁琐,最重要的是,开发人员讨厌这种复杂冗长的文档。

我的建议是,利用好 wiki 系统的树状层级结构,将不同的功能模块进行合理划分,放在不同的目录树中。未来有新的需求,直接在对应的目录下新增文档即可。

3. PRD 是动态的,一定记得及时更新

虽然大家都讨厌需求变更,但在实际项目中却又无法避免。需求变更后,最先做的则是更新需求文档,即使没有需求变更,产品也是不断更新迭代的,对应的产品文档也需及时更新。

很多产品经理经常忽略这件事,以至于一段时间过后,产生很多需求文档和产品线上版本很多不一致的情况,团队有新成员加入或有人离职,又增多了很多解释和说明的成本。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容