百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 博客教程 > 正文

16种简单方法让需求文档更清晰更专业

connygpt 2024-12-18 14:57 7 浏览

需求文档作为整个项目中最重要的内容,直接影响整个项目开发的质量。产品经理的重点在需求文档的功能逻辑、取值逻辑、交互逻辑等描述上,还有就是关注PRD的可读性。PRD是你给到团队中的最重要的文档,团队成员都看着PRD来干活。能够准确、快速、清晰的表达出PRD内容,也有很多注意点。

一、使用合适的需求文档类型

1. Word文档

通过Word进行需求描述,对外提供 Word 或PDF 格式。

容易留存,也比较正规,在阅读上以文字为主。

文档中包含了文字+原型图,使用「原型图片+文档内文字说明」的方式进行描述。

对于没有原型的需求文档。

比如接口需求,偏后端逻辑的需求。

只需要通过文档进行描述即可,直接使用word就行。

2. 原型一体化需求文档

在原型里将需求文档中各个内容全部包含,然后将原型通过在线链接、或者是打包成html 提供出去。

在画原型的时候,同步写上功能描述。

具体选择哪种类型?

——首先看公司要求。

像我之前有公司要求,必须用word,就算是有大量原型的,也只能把页面原型画好,然后再复制到word里,在word写需求内容。

如果公司 / 团队没有要求,具体采用的方式可以看不同的需求类型:

如果涉及到画原型,且原型页面较多的:

——建议使用Axure原型一体化需求文档。

如果只有偏后端需求的,逻辑相关的需求。

比如说是接口需求、算法需求,并不涉及到前端需求的。

—— 建议直接使用 word 写。

如果是做的大项目,同时有功能需求,又有接口需求、算法需求的。

—— 建议都在原型中写需求,使用Axure原型一体化需求文档

我之前做新项目时,Axure文档用于描述功能,然后提供了word文档,重点说接口逻辑。

后来用例评审的时候,测试说不知道word版接口需求,之后我就统一写在Axure里了。

在这篇文章里,我们重点说下「原型一体化需求文档」中的注意点。

目的很简单:提高易读性,提高信息传达效率。

二、页面文件夹层级划分合理

在Axure中可以添加页面文件夹与页面(page),一个合理的页面划分可以很大的提高可读性。

以下 Axure 中的页面称为Page,为避免与原型的页面造成误解。

我觉得不错的划分方法有:

1. 按照菜单层级划分

如下图,这是一个后台的需求文档,我们可以将一级菜单划分成文件夹、将二级菜单作为page。

文件夹名称、Page名称都使用菜单名称。

2. 按照功能点大小划分

当功能点的页面太大时,我们可以新增一个Page进行说明。

如下图,「机构管理」是个表格,有「新增」与「编辑」两个功能。

点击「新增」时,会弹出一个弹窗,但是弹窗里的内容太多,在「机构管理」中添加描述时,内容会很多。

所以就可以再建一个Page,单独对「新增」「编辑」进行说明。

在「机构管理」写到「新增机构」这个功能时,则引导去另外一个页面进行查看具体说明。

如下图:

但是并不是要每个功能点都新建Page。

当一个页面中的功能描述太多、某个功能点的描述有很多时,这时可以单独建一个Page进行说明。

目的是划分出多个Axure Page,避免一个页面中内容过多,影响阅读。

3. 按照Tab页、步骤条中每个页面划分

比如使用了步骤条组件,我们可以把步骤条的每一步对应新建出一个Page,对每一步单独进行说明。

对于Tab页也是,把每个Tab页都新建对应的Page。

二、原型与描述的排版

我们先从原型与功能描述的布局看,我了解到的有3种,推荐的是第1种:

1. 左图右文(推荐)

示例图如下:

这种布局方式是我最建议的方式。

左边放原型,右边放描述内容。

通过编号进行左右对应,可以快速找到对应的说明。

在一屏内容中可以显示出原型与描述,且功能点位置与功能描述的位置有映射关系。

功能点从上到下编号,功能点描述从上到下依次描述,可很容易找到对应位置。

这种布局也会有一个问题,就是当右侧功能描述内容太多时,功能点与功能描述的位置会离得比较远。

极端例子:第1个编号的功能点写了很多,超过了一屏,然后在写之后的功能描述时,需要滑动页面。在看的时候也是,再查看第2点之后的描述时需要不停的上下滑动页面,来找到原型与描述。

2. 上图下文

示例:

在上边放原型图,下边放描述。在很多交互稿中会使用这种方式。

不过这种方式有个最明显的问题:

功能点与描述内容离的太远,眼睛需要上下移动去查看。

如果在一屏内能显示出全部内容,还会好点。当高度超过一屏后,则需要进行上下滑动页面去查看,很费劲。

3. 左右布局

如下图:

原型在中间,左右放描述。

这种视觉流很乱,根据编号来回找。

这种对于PC端大尺寸页面更不适用,需要来回左右滑动。

三、功能序号标注

先画出原型图,在原型中标注「序号」,然后在右侧按照相同的序号进行功能需求描述。

这是一种很方便的方式。

1)标注顺序:一般按照从左到右,从上到下的顺序。

2)标注哪些点:需要进行功能说明的功能点,但是并不意味着每一个点都要进行标注。

一般按照从大到小,按照模块化的方式进行序号标注。

以下方的表单页面为例:

当原型画出后,在页面上标个序号 「 1 」,对页面进行下简介。

一般说明页面是什么,使用角色是谁、权限是什么等等,对整个页面进行说明。

然后继续标注「返回」,对「返回」进行说明。

然后接着对下方的「患者信息」进行标注。

可以看到「患者信息」里有很多字段,我不建议对每个字段进行说明。

可以直接对「患者信息」整个模块进行标注,然后对每个字段进行说明。

(现在看其实上边的需求描述还是不全,比如漏了小数点位数说明,文本输入框内能不能输入表情emoji符号等等)

当页面内出现弹窗时,在右边展示出弹窗原型,接着对弹窗里的内容进行说明。

单独对弹窗里功能点进行标注,然后在下方继续对需求进行说明。

对于弹窗里的内容,我一般从「1」开始重新编号,不把弹窗里的序号和其他页面夹杂在一起。

当存在功能点遗漏,或者要添加新的功能点说明时,这时候会涉及到功能点标注序号的修改。

比如一个页面中的序号标注 1 – 10,这时发现中间少了个标注。

可以采用新增一个 「11 」,然后对「11 」再进行说明,不用严格按照顺序标注的方式。

四、利用连接线

使用连接线连接功能点与功能描述。比如下边的例子。

我不建议这种方式,首先我们已经有了序号,可以找到对应关系。

另外使用连接线,会产生多余的工作量,需要去调整线条,不让线条遮挡内容……

我认为是没有必要使用连接线连接功能点与描述。

不过使用连接线来连接页面,这种方式很好。

但是只针对移动端页面,PC端并不适用。

看个例子:

在下边的页面中,我将全部页面平铺在了一个Page里。

当涉及到页面跳转、弹出层时,可以使用连接线,连接功能点与页面,用于表达页面流程。

在使用连接线时要注意,不要让连接线遮挡内容,连接线也不要交叉。

五、功能描述注意点

功能描述是需求文档中很重要的部分,对于功能描述有几点我们可以注意:

1. 重点内容重点突出

可以使用一个突出的颜色,比如标红、标黄。

功能描述很多时,看的人很容易忽略。

因为大家看文字都是扫过去,不会每个字每个字的去看。

我吃过这个亏,有次验收的时候返现最重要的功能没实现,研发测试说没看到,我一看需求文档上写了,然后研发加班搞得。

无论写什么文档,重点内容都要重点突出。

2. 有必要添加示例

文字说明都会有一定的片面理解。

对于比较复杂的内容我们可以添加示例说明:

3. 采用多分段,多分行,加序号的方式

当文字较多时,分行分段是很有用的方式。

添加序号也能更易阅读。

4. 用好标点符号

如:点击「确认」按钮,跳转至【XXX页面】。

将特殊的名称、动作通过符号框住,可以更清晰的表达。

5. 结合Axure的特性,添加文字链接

当需要阅读者进入另一个Page查看时,可以通过「添加文字链接」交互,点击文字链接快速进入对应Page。

6. 内容变更时保留记录

当描述需要修改时,可以保留原内容,然后添加删除线,并写上修改后的内容,写上修改时间。

如果你直接删除,接着写修改后的内容,你可能会忘了改之前的逻辑。

7. 对于变量值,使用特殊符号标记下

对于会变化的值,我一般使用用两个百分号。

如下方的「科室名称」,会根据不同的选择展示不同的名称,所以我就通过‘%科室名称%’进行表示,然后单独说明,并举例说明。

8. 用表格描述也挺好

除了使用文字,功能描述时还可以使用表格的方式。

比如表单页字段说明,当内容很多时,可以直接使用表格进行说明。

9. 写上页面名称、功能点名称

对于每个页面、每个功能点,可以单独展示出名称,这样便于找到页面。

如果页面重要,也可以说明下页面是什么,干什么的。

六、不建议使用的方式

1. 不要嵌套mockup

这种很不建议,只能展示出首屏内容,当页面多长时,还要添加上下滑动,手机壳也没有任何用。

在纯演示交互时没问题,但是在PRD中,不要用

2. 尽量不要把 功能序号 和 动效 混在一块

举个例子:

比如:画原型使用动态面板,做了个切换Tab的动效。

并且在动态面板里的每个State(面板页面)里的原型上添加了序号标注。

想把动效和功能描述都展示出来。

如果你这样做,你需要在面板页面里标上序号,再退出动态面板,然后再继续写功能描述。

这样非常费时间,而且这个时间很没有必要,不要多给自己找事。

操作的越多,出错的概率就越大。

可以直接把Tab页的每个页面平铺出来,直接进行标注序号、功能描述即可。

不要迷恋动态交互。

3. 不要使用看起来很炫酷的Axure需求文档模板

对于需求文档,只要你说明白,让看的人能看明白,你能最快的完成需求文档输出就行了。

有些原型需求文档模板,提供了很多动态交互,可以在模板里写很多内容。

这个也没有意义,你写内容的时候很费事,看的人也麻烦。

就直接规规矩矩的使用Axure文件夹、Page放不同的内容就可以了。

七、总结

我们从原型一体化需求文档中包含的内容做了说明,来提供PRD的易读性。

还有其它点:

把Page底色设置成护眼的颜色、调整功能描述文字的字间距、行间距等。

还有文字颜色,我一直使用的Antdesign组件库中的刺眼玫红,我也想打算改个柔和的颜色。

产品经理要考虑用户体验,需求文档是产品经理输出的最核心的产品,所以这个产品的用户体验我们也要好好优化。

本文由人人都是产品经理作者【王大鹿】,微信公众号:【产品大鹿】,原创/授权 发布于人人都是产品经理,未经许可,禁止转载。

题图来自Unsplash,基于 CC0 协议。

相关推荐

自学Python,写一个挨打的游戏代码来初识While循环

自学Python的第11天。旋转~跳跃~,我~闭着眼!学完循环,沐浴着while的光芒,闲来无事和同事一起扯皮,我说:“编程语言好神奇,一个小小的循环,竟然在生活中也可以找到原理和例子”,同事也...

常用的 Python 工具与资源,你知道几个?

最近几年你会发现,越来越多的人开始学习Python,工欲善其事必先利其器,今天纬软小编就跟大家分享一些常用的Python工具与资源,记得收藏哦!不然下次就找不到我了。1、PycharmPychar...

一张思维导图概括Python的基本语法, 一周的学习成果都在里面了

一周总结不知不觉已经自学Python一周的时间了,这一周,从认识Python到安装Python,再到基本语法和基本数据类型,对于小白的我来说无比艰辛的,充满坎坷。最主要的是每天学习时间有限。只...

三日速成python?打工人,小心钱包,别当韭菜

随着人工智能的热度越来越高,许多非计算机专业的同学们也都纷纷投入到学习编程的道路上来。而Python,作为一种相对比较容易上手的语言,也越来越受欢迎。网络上各类网课层出不穷,各式广告令人眼花缭乱。某些...

Python自动化软件测试怎么学?路线和方法都在这里了

Python自动化测试是指使用Python编程语言和相关工具,对软件系统进行自动化测试的过程。学习Python自动化测试需要掌握以下技术:Python编程语言:学习Python自动化测试需要先掌握Py...

Python从放弃到入门:公众号历史文章爬取为例谈快速学习技能

这篇文章不谈江流所专研的营销与运营,而聊一聊技能学习之路,聊一聊Python这门最简单的编程语言该如何学习,我完成的第一个Python项目,将任意公众号的所有历史文章导出成PDF电子书。或许我这个Py...

【黑客必会】python学习计划

阅读Python文档从Python官方网站上下载并阅读Python最新版本的文档(中文版),这是学习Python的最好方式。对于每个新概念和想法,请尝试运行一些代码片段,并检查生成的输出。这将帮助您更...

公布了!2025CDA考试安排

CDA数据分析师报考流程数据分析师是指在不同行业中专门从事行业数据搜集、整理、分析依据数据作出行业研究评估的专业人员CDA证书分为1-3级,中英文双证就业面广,含金量高!!?报考条件:满18...

一文搞懂全排列、组合、子集问题(经典回溯递归)

原创公众号:【bigsai】头条号:程序员bigsai前言Hello,大家好,我是bigsai,longtimenosee!在刷题和面试过程中,我们经常遇到一些排列组合类的问题,而全排列、组合...

「西法带你学算法」一次搞定前缀和

我花了几天时间,从力扣中精选了五道相同思想的题目,来帮助大家解套,如果觉得文章对你有用,记得点赞分享,让我看到你的认可,有动力继续做下去。467.环绕字符串中唯一的子字符串[1](中等)795.区...

平均数的5种方法,你用过几种方法?

平均数,看似很简单的东西,其实里面包含着很多学问。今天,分享5种经常会用到的平均数方法。1.算术平均法用到最多的莫过于算术平均法,考试平均分、平均工资等等,都是用到这个。=AVERAGE(B2:B11...

【干货收藏】如何最简单、通俗地理解决策树分类算法?

决策树(Decisiontree)是基于已知各种情况(特征取值)的基础上,通过构建树型决策结构来进行分析的一种方式,是常用的有监督的分类算法。决策树算法是机器学习中的一种经典算法,它通过一系列的规则...

面试必备:回溯算法详解

我们刷leetcode的时候,经常会遇到回溯算法类型题目。回溯算法是五大基本算法之一,一般大厂也喜欢问。今天跟大家一起来学习回溯算法的套路,文章如果有不正确的地方,欢迎大家指出哈,感谢感谢~什么是回溯...

「机器学习」决策树——ID3、C4.5、CART(非常详细)

决策树是一个非常常见并且优秀的机器学习算法,它易于理解、可解释性强,其可作为分类算法,也可用于回归模型。本文将分三篇介绍决策树,第一篇介绍基本树(包括ID3、C4.5、CART),第二篇介绍Ran...

大话AI算法: 决策树

所谓的决策树算法,通俗的说就是建立一个树形的结构,通过这个结构去一层一层的筛选判断问题是否好坏的算法。比如判断一个西瓜是否好瓜,有20条西瓜的样本提供给你,让你根据这20条(通过机器学习)建立起...