文档章节

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

狼行-狼行
 狼行-狼行
发布于 2017/09/08 16:19
字数 1786
阅读 27
收藏 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
博文 84
码字总数 13294
作品 0
济南
高级程序员
私信 提问
创业公司的研发架构:Step By Step

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

孤岛旭日
2015/04/14
71
0
技术迭代日益快速的时代下,技术人如何自处?

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

茶轴的青春
2018/08/01
0
0
@程序员,幼儿园小班都在学 AI,就问你慌不慌?

近日,网上流传一组《人工智能实验教材》的图片,教材是为幼儿园小班的小朋友们设计的,还只是上册。 根据公开信息,《人工智能实验教材》纸质教材合计33本,覆盖幼儿到青少年全年龄段。 也就...

CSDN资讯
2018/12/07
0
0
腾讯高级工程师自述:十年沉浮,我为什么选择离开管理岗位

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

yuanwx0328
2017/11/15
0
0
腾讯高级工程师的自述:如何管理技术团队

任何项目都需要经过团队的共同作用才能最终实现。对于游戏项目来说也是一样,只有团队里的成员心力都往一处使,才能发挥最好的效果。但是要想管理好游戏技术团队可不是什么容易的事。不过我们...

西谷开源
2018/12/26
0
0

没有更多内容

加载失败,请刷新页面

加载更多

cnetos7+docker+rancher构建基于DevOps的全自动CI【01】

来自DevOps实践分享,分享从开发代码到生产环境部署的一条龙操作的实践及经验, 包含工具技术的选型及考量、私有代码库与私有镜像库的应用等。 1、环境选择 安装Rancher环境,一定要在干净的...

Elson
1分钟前
0
0
21分钟教会你分析MaxCompute账单

背景 阿里云大计算服务MaxCompute是一款商业化的大数据分析平台,其计算资源有预付费和后付费两种计费方式。并且产品每天按照project为维度进行计量计费(账单基本情况下会第二天6点前产出)...

zhaowei121
5分钟前
0
0
CTO职场解惑指南系列(一)

基于科技能够改变世界的事实,几乎每个公司的程序员都自带闪光灯。程序员的手和普通人的手自然是有区别的,“我们可是用双手改变了世界” 。(码农真的是靠双手吃饭,呵呵) 这个世界上但凡靠...

阿里云云栖社区
9分钟前
0
0
css实现图片自适应容器宽高

css实现图片自适应容器宽高的做法一般如下所示 <style>div{width: 200px; height: 200px}div img{width: 100%; height: 100%}</style><div><img src="xxxx.png" /></div> 当外层容......

小草先森
9分钟前
0
0
PlatON在CentOS上编译部署

本文作者为万向区块链CTO罗荣阁。 目录 PlatON在CentOS上编译部署 1. CentOS 环境准备 1.1. 使用rpm 安装devtoolset-7 1.2. 使用rpm 安装dos2unix 1.3. 准备PlatON代码 1.4. 确保build脚本正...

万向区块链
17分钟前
9
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部