文档章节

腾讯产品总监教我如何写出让程序员闭嘴的需求文档

狼行-狼行
 狼行-狼行
发布于 2017/09/08 16:19
字数 1786
阅读 26
收藏 3

读完这篇文章,你就能学会如何写出让程序员无法吐槽的产品文档!

需求文档是产品经理必须掌握的基本技能,核心作用是向技术人员说清楚你的产品设计方案,一份好文档需要具备哪些要素,我来告诉你!

以下为我的课程复盘笔记,前腾讯会员产品经理亲授的写文档方法。

问题

带着这些问题思考,如果这些问题你都能回答,你还是需要继续往下看。

1.原型与需求文档之间存在什么关系?

答:两者相互补充,原型是需求的视觉表现,更加注重交互,而文档是需求的文字表现,更注重细节。

2.原型有哪些分类?

答:高保真与低保真,根据工作需求进行选择。

3.需求文档具备哪些内容?

答:文章的第4点有详细描述

4.优秀的需求文档是怎么样的?

答:文章的第7点有详细描述

5.如何锻炼原型设计与需求文档撰写的能力?

答:多看,多想,多写,结构化思考

课程大纲

 

与原型设计相比,需求文档更加重要。

在我看来,两者是相辅相成的,必须结合使用,文档是功能细节的体现,原型是交互细节的体现。

收获

1.原型的作用是什么

原型是一种用于提高沟通效率的工具,便于相关人员了解需求,保障完成效果。

2.原型的分类

1.低保真原型

 

低保真原型往往作用与产品的初期,利用线框图把信息组织架构体现出来,属于横向原型设计,缺少交互细节,时间不足时往往使用低保真原型促进沟通。

2.高保真原型

 

高保真原型用于确定功能之后,对交互细节进行展现,包含页面之间的跳转关系,往往是一个可操作原型。

高保真原型耗时长,部分特殊功能通过高保真原型能够体现最终效果,也能用来检验开发的成果。

制作原型的步骤

1.分析需求

罗列出原型需要实现的需求。

2.了解功能分布

功能的层级关系。

3.明确页面层级

页面之间有明确存在的层级关系,每一层实现的功能与存在的元素。

4.绘制基本原型

5.检验,修改原型

往往第一次制作的都会被打回,做好心理准备吧。

需求文档的目标用户与作用

需求文档就是产品功能说明书,包含大量的功能细节,目的是提高沟通效率,避免研发过程出现误会。

阅读需求文档的人主要是项目相关的负责人,例如研发,UI,测试等等。

需求文档包含的内容

 

1.需求背景与目标说明

你得让别人知道你为什么要做,要做到什么程度,用户检验功能完成情况。

2.特性列表

所谓特性,其实就是功能模块,把需要做的功能模块都罗列出来,主要用于明确需要做的功能有哪些,用图表体现更佳

拆分标准:

1.内部逻辑(不同的功能模块,不同的页面)

2.重要的特性单独列出,例如提示语

3.主要逻辑

每个特性之下的操作逻辑,简单特性可以文字说明,复杂特性建议用流程图表现。

帮助梳理逻辑,减少细节遗留。

4.特性功能点

补充每个功能点的相关细节描述,是开发,与测试工作的重要依据。

包括:

1.流程细节描述。

2.正常逻辑表现,异常逻辑表现。

3.文案内容,性能需求。

4.交互图(可无)

5.特性需求,性能需求,数据上报

这一部分类似备注,说明了做这个功能要达到怎样的程度,需要再哪些地方进行数据埋点。

6.版本号记录,迭代说明

便于回顾整个过程,进行复盘。

需求文档撰写四步走

1.想-需求

三思而后行,下笔之前想清楚你的需求,需求就是一份文字版的问题解决方案:

你想做什么功能?

这个功能主要的用户是谁?

这个功能重要吗?优先级高吗?

这个功能的流程想清楚了吗?还有极端情况没有考虑吗?

........

2.列-特性

性清楚后,列出你需要做的所有功能特性:

功能特性

界面特性

性能要求

数据上报

操作流程

3.写-初稿

根据特性点,开始写初稿,按照一定的逻辑分特性,遵循MECE原则,要求做到:

需求结构完整

逻辑清晰

描述准确

4.补-细节

重读整份文档,找出不足之处进行补充。把自己代入各个相关负责人的职位当中,看看自己能否准确明白文档的内容。

文档撰写技巧

标题

区分版本号,每份文档进行迭代都要加入内容与版本号,如V1.0。

章节

每一个功能需求单独一个章节, 分开进行描述。

用语

精简,准确地表达。

7.好的需求文档需要做到以下几点

正确

正确满足产品需求,逻辑清晰。

完备

文档内容完备,把所有场景,极端情况,逻辑流程都写出来了。

无歧义

文字描述准确,没有产生歧义。

优先级

每个功能特性都包含优先级。

可验证

功能是可以被准确验证的。

8.需求文档修炼指南

需求文档是产品经理的基本功,每个人都会写,但是不是每个人都能写好,所以需要不断地精进这项技能。

多看

多看优秀的需求文档,了解一份文档为什么优秀,看到不好的地方,尝试批改它,让它更加优秀。

多想

需求文档是思想的呈现,你对一个需求想得越多,了解得越深,写出来的内容就会更加准确,完备。

多讨论

放下你的羞耻心,把你的文档拿出来和大家一起讨论,可能会受到10000点的伤害,不过别担心,你会成长很快。

结构化思考

看了老师给出的几份优秀的文档,都遵循结构化思考得原则,结论先行,然后再分点描述,一层一层地进行下去。

在生活,工作中养成结构化思考得习惯,让你的表达更加清晰,别人接受起来也更加容易。

本文转载自:

共有 人打赏支持
狼行-狼行
粉丝 11
博文 83
码字总数 7001
作品 0
济南
高级程序员
私信 提问
技术迭代日益快速的时代下,技术人如何自处?

科技发展的迅速是一件令人兴奋的事情。但如果站在一个技术开发者的角度去看的话,反而是一件心累的事儿,因为想要跟上科技更新的脚步并不是一件容易的事。所以作为技术人,我们是紧跟技术发展...

茶轴的青春
08/01
0
0
创业公司的研发架构:Step By Step

如何管理一家创业型公司,举目四望要做的很多,但资源、精力有限,如何从白纸一张一步步地架设起高楼大厦?我想这是困扰很多管理者的难题,我经手过几家创业公司,在这方面算是有些经验可以分...

孤岛旭日
2015/04/14
71
0
腾讯高级工程师自述:十年沉浮,我为什么选择离开管理岗位

腾讯高级工程师自述:十年沉浮,我为什么选择离开管理岗位? 作者:韩伟来源:韩大订阅号|2017-11-06 08:52 从 2001 年在网易成为一名项目经理,到 2011 年进入腾讯,我经历了从“领导”几个...

yuanwx0328
2017/11/15
0
0
技术管理经验谈:十年沉浮,最后我选择了离开……

作者介绍 韩伟,腾讯科技互娱研发部架构师。曾在网易任职8年,担任无线事业部产品总监。多年来一直从事技术开发,擅长开发高性能系统,对于软件架构设计也有丰富的经验。个人的技术兴趣在设计...

韩伟
2017/08/25
0
0
从一个普通程序猿到CTO,要经历哪几个阶段?

点击上方“程序员大咖”,选择“置顶公众号” 关键时刻,第一时间送达! 不想当CTO的技术开发,不是好程序员,那么从一个普通程序员到顶级的CTO都要经历哪些关键阶段,又都需要具备怎样的工作...

px01ih8
2017/12/10
0
0

没有更多内容

加载失败,请刷新页面

加载更多

Nginx+Keepalived实现站点高可用

Nginx+Keepalived实现站点高可用

吴伟祥
9分钟前
0
0
git常用命令速查表

任梁荣
12分钟前
1
0
一文带你学会使用YOLO及Opencv完成图像及视频流目标检测(上)

摘要: 本文介绍使用opencv和yolo完成图像目标检测,代码解释详细,附源码,上手快。 计算机视觉领域中,目标检测一直是工业应用上比较热门且成熟的应用领域,比如人脸识别、行人检测等,国内...

阿里云官方博客
14分钟前
0
0
SpringBoot整合RabbitMQ之典型应用场景实战二

实战前言 RabbitMQ 作为目前应用相当广泛的消息中间件,在企业级应用、微服务应用中充当着重要的角色。特别是在一些典型的应用场景以及业务模块中具有重要的作用,比如业务服务模块解耦、异步...

liwei2000
16分钟前
0
0
ES6这些就够了

刚开始用vue或者react,很多时候我们都会把ES6这位大兄dei加入我们的技术栈中。但是ES6那么多那么多特性,我们真的需要全部都掌握吗?秉着二八原则,掌握好常用的、有用的这个可以让我们的开...

文文1
25分钟前
0
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部