百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

写了一年的需求文档,我想告诉你……

ccwgpt 2024-11-20 13:09 40 浏览 0 评论

本文作者写了大概一年的需求文档,对需求文档也有了不同于一开始的认识,也积累了一些经验,在此分享给大家。

到目前为止,大概写了一年的需求文档。

整个过程从零开始,通过自己的探索(反复练习与参考资料),也算能产出一份比较满意的需求文档,接下来需求文档的作用说起。

需求文档的作用

1. 帮助产品经理梳理功能逻辑,构建产品的框架

很多人会认为需求文档是给开发同学与设计同学看的,目的是让他们更好地理解需求。但经过一年的实践,越发觉得产品同学才是需求文档最大的受益者。

写需求文档过程,也是构思产品的过程。需求文档中包含『产品结构图』与『逻辑流程图』,产品结构图展示的是产品的具体模块与功能,而逻辑流程图则说明了功能的具体步骤。将他们写清楚后,产品的骨架也搭建了起来。

另外,在画产品原型、补充产品逻辑的过程中,能够帮助产品同学理清产品的细节,确保产品在最初的设计上尽可能的完善与流畅,最大限度避免了后续出错的可能。

2. 辅助产品同学阐述产品需求

在进行需求评审的时候,需求文档是辅助产品同学阐述产品需求的重要支撑,类似于演讲的PPT。很多时候单靠口头描述,很难说清产品的具体细节与逻辑,如果结合着产品原型图,则会事半功倍。

十分建议将产品逻辑背后的『理由/产品解释』写到需求文档中,例如弹窗的『确定』与『取消』按钮,突出『确定』按钮的原因是想让用户完成期待的操作;添加『功能结果页』的原因是为了增加广告的展示频次等。

这样做有两个好处:一是能让产品同学在设计功能的过程中,不断的自我质疑,减少功能逻辑潜在的缺陷;二是能让别人更好理解需求本身,增加沟通的流畅性。

3. 减少沟通成本

需求文档对于设计与开发的同学来说,更像是一份参考文档或者需求词典。在他们困惑的时候,能够通过翻阅需求文档,解决疑惑点,从而省去了询问的过程。这就要求产品同学在编写需求文档的时候,要尽可能细致。

一份需求文档,除了原型图外,还应该写清楚『开发注意事项』与『设计注意事项』。开发注意事项包含页面间的跳转逻辑,每个组件的操作响应,操作之间的避让逻辑等;而设计的注意事项应该包含页面组件的表现优先级,组件的不同状态等。

另外,如果牵扯到广告变现,还要将广告的请求时机,展示时机说清楚。

在产品实现正式开始之前,产品同学一定要对开发同学与设计同学说清楚原型图中的每个要点,确保他们对于需求的理解和自己达成一致。这样在推进产品落地的过程中,才能充分发挥需求文档参考作用。

4. 产品存档

处于维护期的老产品,如果没有相关的文档,对于刚接手的人,简直是一个灾难。因为一款产品从发布到成熟,期间经历过各种坑,缺少对应的文档的解释,很多功能逻辑都无法理解,可能需要重新趟一次浑水,才能将老产品彻底的掌握。这个过程本身是痛苦的,成本也是巨大的。

但是,如果有比较完备的参考文档,接手过程就会顺利很多。另外,在遇到产品问题的时候,也能够通过翻阅备份文档,快速定位问题,极大提高了工作效率。

5. 需求文档构成元素介绍

1)逻辑流程图

  1. 将产品目标拆解实现步骤,将相关的步骤聚合为产品模块,每个模块之间低耦合,高聚类;
  2. 模块内使用流程图将具体的逻辑串联起来,每个模块内的逻辑流程基本上都可以从头到尾执行完毕,少有交错的情况;
  3. 如果有重复出现的逻辑流程,要使用子流程进行概括,并且在主流程中使用子流程进行替换;

2)原型图

  1. 画清楚页面的组件布局以及文案信息;
  2. 各个组件的展示优先级,通过组件的大小、颜色的深浅表现出来;
  3. 页面/组件的不同状态展示(选中状态);
  4. 页面之间的跳转逻辑(使用跳转);
  5. 每个组件的操作响应(使用简单的流程线);
  6. 广告的展示位置。

3)开发注意事项

  1. 控件的操作响应;
  2. 页面间的跳转逻辑;
  3. 状态更改的时机与条件;
  4. 广告的请求、展示逻辑。

4)设计注意事项

  1. 组件的优先级说明;
  2. 组件自身在各种场景下的变化。

5)产品解释

  1. 说清楚页面/组件要实现的产品目的

小结

虽然写出一份完整的需求文档,看起来要花很长的时间。但实际纯粹输出文档的时间并不多,大概一到两天的时间。真正耗费时间的是产品框架的搭建与逻辑的梳理,而这一块对于任何产品都是必不可少的。

需求文档如果做得比较完善,节省出的沟通成本是巨大的。在实践的过程中,一份完整的需求文档,加上充足的前期沟通,大致能节省后期70%的沟通成本。省下来的沟通成本所带来的是成倍的效率,因为沟通前后的精力转移成本是非常巨大的。

当然,需求文档的详略主要取决于团队成员对于项目的理解。

如果项目本身就很小,每个人对于项目都有着较深的理解,需求文档只需要简单的概述需求本身;对于比较大型的、复杂的产品,需求文档则越完善越好。

#专栏作家#

MING,个人公众号:MING的大航海,知乎专栏:产品见知录,人人都是产品经理专栏作家。一只专注于个人成长的产品汪,沉迷『方法论』,只分享值得收藏的『硬干货』!

本文原创发布于人人都是产品经理。未经许可,禁止转载。

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

相关推荐

团队管理“布阵术”:3招让你的团队战斗力爆表!

为何古代军队能够以一当十?为何现代企业有的团队高效似“特种部队”,有的却松散若“游击队”?**答案正隐匿于“布阵术”之中!**今时今日,让我们从古代兵法里萃取3个核心要义,助您塑造一支战斗力爆棚的...

知情人士回应字节大模型团队架构调整

【知情人士回应字节大模型团队架构调整】财联社2月21日电,针对原谷歌DeepMind副总裁吴永辉加入字节跳动后引发的团队调整问题,知情人士回应称:吴永辉博士主要负责AI基础研究探索工作,偏基础研究;A...

豆包大模型团队开源RLHF框架,训练吞吐量最高提升20倍

强化学习(RL)对大模型复杂推理能力提升有关键作用,但其复杂的计算流程对训练和部署也带来了巨大挑战。近日,字节跳动豆包大模型团队与香港大学联合提出HybridFlow。这是一个灵活高效的RL/RL...

创业团队如何设计股权架构及分配(创业团队如何设计股权架构及分配方案)

创业团队的股权架构设计,决定了公司在随后发展中呈现出的股权布局。如果最初的股权架构就存在先天不足,公司就很难顺利、稳定地成长起来。因此,创业之初,对股权设计应慎之又慎,避免留下巨大隐患和风险。两个人如...

消息称吴永辉入职后引发字节大模型团队架构大调整

2月21日,有消息称前谷歌大佬吴永辉加入字节跳动,并担任大模型团队Seed基础研究负责人后,引发了字节跳动大模型团队架构大调整。多名原本向朱文佳汇报的算法和技术负责人开始转向吴永辉汇报。简单来说,就是...

31页组织效能提升模型,经营管理团队搭建框架与权责定位

分享职场干货,提升能力!为职场精英打造个人知识体系,升职加薪!31页组织效能提升模型如何拿到分享的源文件:请您关注本头条号,然后私信本头条号“文米”2个字,按照操作流程,专人负责发送源文件给您。...

异形柱结构(异形柱结构技术规程)

下列关于混凝土异形柱结构设计的说法,其中何项正确?(A)混凝土异形柱框架结构可用于所有非抗震和抗震设防地区的一般居住建筑。(B)抗震设防烈度为6度时,对标准设防类(丙类)采用异形柱结构的建筑可不进行地...

职场干货:金字塔原理(金字塔原理实战篇)

金字塔原理的适用范围:金字塔原理适用于所有需要构建清晰逻辑框架的文章。第一篇:表达的逻辑。如何利用金字塔原理构建基本的金字塔结构受众(包括读者、听众、观众或学员)最容易理解的顺序:先了解主要的、抽象的...

底部剪力法(底部剪力法的基本原理)

某四层钢筋混凝土框架结构,计算简图如图1所示。抗震设防类别为丙类,抗震设防烈度为8度(0.2g),Ⅱ类场地,设计地震分组为第一组,第一自振周期T1=0.55s。一至四层的楼层侧向刚度依次为:K1=1...

结构等效重力荷载代表值(等效重力荷载系数)

某五层钢筋混凝土框架结构办公楼,房屋高度25.45m。抗震设防烈度8度,设防类别丙类,设计基本地震加速度0.2g,设计地震分组第二组,场地类别为Ⅱ类,混凝土强度等级C30。该结构平面和竖向均规则。假定...

体系结构已成昭告后世善莫大焉(体系构架是什么意思)

实践先行也理论已初步完成框架结构留余后人后世子孙俗话说前人栽树后人乘凉在夏商周大明大清民国共和前人栽树下吾之辈已完成结构体系又俗话说青出于蓝而胜于蓝各个时期任务不同吾辈探索框架结构体系经历有限肯定发展...

框架柱抗震构造要求(框架柱抗震设计)

某现浇钢筋混凝土框架-剪力墙结构高层办公楼,抗震设防烈度为8度(0.2g),场地类别为Ⅱ类,抗震等级:框架二级,剪力墙一级,混凝土强度等级:框架柱及剪力墙C50,框架梁及楼板C35,纵向钢筋及箍筋均采...

梁的刚度、挠度控制(钢梁挠度过大会引起什么原因)

某办公楼为现浇钢筋混凝土框架结构,r0=1.0,混凝土强度等级C35,纵向钢筋采用HRB400,箍筋采用HPB300。其二层(中间楼层)的局部平面图和次梁L-1的计算简图如图1~3(Z)所示,其中,K...

死要面子!有钱做大玻璃窗,却没有钱做“柱和梁”,不怕房塌吗?

活久见,有钱做2层落地大玻璃窗,却没有钱做“柱子和圈梁”,这样的农村自建房,安全吗?最近刷到个魔幻施工现场,如下图,这栋5开间的农村自建房,居然做了2个全景落地窗仔细观察,这2个落地窗还是飘窗,为了追...

不是承重墙,物业也不让拆?话说装修就一定要拆墙才行么

最近发现好多朋友装修时总想拆墙“爆改”空间,别以为只要避开承重墙就能随便砸!我家楼上邻居去年装修,拆了阳台矮墙想扩客厅,结果物业直接上门叫停。后来才知道,这种配重墙拆了会让阳台承重失衡,整栋楼都可能变...

取消回复欢迎 发表评论: