APP推广合作
联系“鸟哥笔记小乔”
好的产品需求文档拥有6个共性
2021-02-09 10:42:46


“不专业的产品经理,你连ta需求文档都读不下去”,这是近期很有共鸣的一句话,产品需求文档算得上是产品经理的半个大脑,因为产品需求文档是前期所有工作的结果,那一份可读性高的需求文档到底有哪些共性?

首先先了解我们大脑是怎么理解文字或一段话的,我们遇到事情需要去理解时就会将得到的信息往已知的模型上靠,一旦如果我们大脑有类似模型,理解起来就很容易。如果沒找到类似的模型,理解就很困难。

1.声明名词,帮助阅读者建立已知模型 

为什么提到Toast大家知道是提示对话框,因为Toast已经被多次教育大脑已经“定义”"好了,大脑能直接解析并获得信息,但如果需求文档中经常出现的或者陌生的词,就可以在文档开头定义清楚,这样一来就能让阅读者清晰明白,这个常出现或者陌生的词到底是什么意思。有点类似于纸质书里面的注释,避免理解误差,达成共识。

2.用开发熟悉的语言来写文档

网上经常会有人问,开发喜欢看怎样的需求文档,用户开发熟悉的语言来写,即一些逻辑描述和开发平时常接触描述一致,如开头所提到,往开发已知的信息模型上靠,比如一个列表的排序规则,我们想描述时间越近排在越前的时候,通常会这么写“XXX按动态更新时间从大到小排序”,最好的应该这么描述是“按更新时间倒序”,“倒序/升序/降序”应该已经存在每个开发人员的已知信息模型中,理解起来更容易。

除了排序外比较常见的还有时间单位,可以用yyyy-MM-dd hh:MM:ss即年月日时分秒来代替,相比文字描述研发对字母代码更熟悉。

3.结构化图文搭配

如果一个页面需求比较复杂且是纯文字描述性的文字,一大坨一大坨堆在一起别说开发人员,就算是你接手了离职同事的文档,相信你也看不不下去,能用图来描述的情况下就不要用文字,图+文字搭配可读性会更高,一图胜千言,因为实际开发时,开发需要考虑后续逻辑变化,如果只有纯描述性的文字,开发可能还得猜后续逻辑变化,但如果有流程图/泳道图搭配文字描述,那结果就完全不一样了。 

4.善用表格

如果一个需求涉及“一对多”或者“多对多”的时候,比如根据“不同用户等级给予不同的文案提示”,用表格把“等级和对应提示文案”装起来,真的会有一目十行的效果。我们得感谢有“表格”这种东西存在,因为如果没有表格,我们可能得多喝5L水和开发面对面沟通,估计后续还得在微信上敲5000个字。

5.巧用公式 

公式是最常见的逻辑处理之一,涉及到一些加减乘除的计算逻辑,尽可能公式化来描述需求,这样能简化开发的理解和思考。比如我们在描述积分变化情况时,通常喜欢用纯描述性的文字来写文档,“点击签到按钮用户积分加1,点击抽奖按钮用户积分-20” 

如果把纯描述性文字转换成公式化变成以下这样

“点击签到按钮 用户积分 = 总积分 + 1”

“点击兑换按钮 用户积分 = 总积分 - 20 ”

是不是更加直观更符合开发语言。

但是记得不要“得寸进尺”,如果觉得自己一定开发基础,还想进一步提高开发人员阅读效率,是不是可以写成“伪代码”直接给开发照猫画虎。个人不建议这么做,因为不同开发语言写法都不一样,你理解的语言在开发角度可能不容易理解,我以前就犯过一个错误,web端的弹窗alert,在Android端得用AlertDialog安卓开发才容易理解,不然还得理解你这个alert才能转化自己的思路,并且需求文档阅读人员里面还包含了测试人员,就算开发理解了,测试不一定会理解。

一些能被复用的产品模块,尽可能保持同样的写法,如果描述的画风不一样,开发有可能给你做出不一样的东西,当然上面所提到的内容,均建立在逻辑没有硬伤的前提下。

6.持续进步

可以去看一下部分框架和平台的开发文档,比如web端常见的Ant Design,Element,如果产品形态是小程序可以去看微信小程序开发文档等等, 这样能够了解框架/平台的更新日志,这种信息了解的越多,对技术理解越深入,这样不管是写文档还是和开发沟通都会有很大帮助,同时这也是洞察力的一种表现。因为部分新能力更希望是你来提醒开发,这样开发更有积极性来响应,而不是平台更新了某个功能你毫不知情,反过来开发来提醒你,就显得非常被动。

切勿硬生生套用模板

经常会有一些读者加微信后会问“园长,你有PRD模板吗”,模板只是面上的东西,对于新人来说,模板只能给自己提供一个思路,而不是全部套用,毕竟合适自己的才是最好的,所以最好的模板内容模块应该是内部多次实操后总结出来的。

-END-

首席吹牛官
分享到朋友圈
收藏
收藏
评分

综合评分:

我的评分
Xinstall 15天会员特权
Xinstall是专业的数据分析服务商,帮企业追踪渠道安装来源、裂变拉新统计、广告流量指导等,广泛应用于广告效果统计、APP地推与CPS/CPA归属统计等方面。
20羽毛
立即兑换
一书一课30天会员体验卡
领30天VIP会员,110+门职场大课,250+本精读好书免费学!助你提升职场力!
20羽毛
立即兑换
顺丰同城急送全国通用20元优惠券
顺丰同城急送是顺丰推出的平均1小时送全城的即时快送服务,专业安全,准时送达!
30羽毛
立即兑换
首席吹牛官
首席吹牛官
发表文章9
互联网圈十八线写手 颜良文丑 欢迎交流
确认要消耗 0羽毛购买
好的产品需求文档拥有6个共性吗?
考虑一下
很遗憾,羽毛不足
我知道了

我们致力于提供一个高质量内容的交流平台。为落实国家互联网信息办公室“依法管网、依法办网、依法上网”的要求,为完善跟帖评论自律管理,为了保护用户创造的内容、维护开放、真实、专业的平台氛围,我们团队将依据本公约中的条款对注册用户和发布在本平台的内容进行管理。平台鼓励用户创作、发布优质内容,同时也将采取必要措施管理违法、侵权或有其他不良影响的网络信息。


一、根据《网络信息内容生态治理规定》《中华人民共和国未成年人保护法》等法律法规,对以下违法、不良信息或存在危害的行为进行处理。
1. 违反法律法规的信息,主要表现为:
    1)反对宪法所确定的基本原则;
    2)危害国家安全,泄露国家秘密,颠覆国家政权,破坏国家统一,损害国家荣誉和利益;
    3)侮辱、滥用英烈形象,歪曲、丑化、亵渎、否定英雄烈士事迹和精神,以侮辱、诽谤或者其他方式侵害英雄烈士的姓名、肖像、名誉、荣誉;
    4)宣扬恐怖主义、极端主义或者煽动实施恐怖活动、极端主义活动;
    5)煽动民族仇恨、民族歧视,破坏民族团结;
    6)破坏国家宗教政策,宣扬邪教和封建迷信;
    7)散布谣言,扰乱社会秩序,破坏社会稳定;
    8)宣扬淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪;
    9)煽动非法集会、结社、游行、示威、聚众扰乱社会秩序;
    10)侮辱或者诽谤他人,侵害他人名誉、隐私和其他合法权益;
    11)通过网络以文字、图片、音视频等形式,对未成年人实施侮辱、诽谤、威胁或者恶意损害未成年人形象进行网络欺凌的;
    12)危害未成年人身心健康的;
    13)含有法律、行政法规禁止的其他内容;


2. 不友善:不尊重用户及其所贡献内容的信息或行为。主要表现为:
    1)轻蔑:贬低、轻视他人及其劳动成果;
    2)诽谤:捏造、散布虚假事实,损害他人名誉;
    3)嘲讽:以比喻、夸张、侮辱性的手法对他人或其行为进行揭露或描述,以此来激怒他人;
    4)挑衅:以不友好的方式激怒他人,意图使对方对自己的言论作出回应,蓄意制造事端;
    5)羞辱:贬低他人的能力、行为、生理或身份特征,让对方难堪;
    6)谩骂:以不文明的语言对他人进行负面评价;
    7)歧视:煽动人群歧视、地域歧视等,针对他人的民族、种族、宗教、性取向、性别、年龄、地域、生理特征等身份或者归类的攻击;
    8)威胁:许诺以不良的后果来迫使他人服从自己的意志;


3. 发布垃圾广告信息:以推广曝光为目的,发布影响用户体验、扰乱本网站秩序的内容,或进行相关行为。主要表现为:
    1)多次发布包含售卖产品、提供服务、宣传推广内容的垃圾广告。包括但不限于以下几种形式:
    2)单个帐号多次发布包含垃圾广告的内容;
    3)多个广告帐号互相配合发布、传播包含垃圾广告的内容;
    4)多次发布包含欺骗性外链的内容,如未注明的淘宝客链接、跳转网站等,诱骗用户点击链接
    5)发布大量包含推广链接、产品、品牌等内容获取搜索引擎中的不正当曝光;
    6)购买或出售帐号之间虚假地互动,发布干扰网站秩序的推广内容及相关交易。
    7)发布包含欺骗性的恶意营销内容,如通过伪造经历、冒充他人等方式进行恶意营销;
    8)使用特殊符号、图片等方式规避垃圾广告内容审核的广告内容。


4. 色情低俗信息,主要表现为:
    1)包含自己或他人性经验的细节描述或露骨的感受描述;
    2)涉及色情段子、两性笑话的低俗内容;
    3)配图、头图中包含庸俗或挑逗性图片的内容;
    4)带有性暗示、性挑逗等易使人产生性联想;
    5)展现血腥、惊悚、残忍等致人身心不适;
    6)炒作绯闻、丑闻、劣迹等;
    7)宣扬低俗、庸俗、媚俗内容。


5. 不实信息,主要表现为:
    1)可能存在事实性错误或者造谣等内容;
    2)存在事实夸大、伪造虚假经历等误导他人的内容;
    3)伪造身份、冒充他人,通过头像、用户名等个人信息暗示自己具有特定身份,或与特定机构或个人存在关联。


6. 传播封建迷信,主要表现为:
    1)找人算命、测字、占卜、解梦、化解厄运、使用迷信方式治病;
    2)求推荐算命看相大师;
    3)针对具体风水等问题进行求助或咨询;
    4)问自己或他人的八字、六爻、星盘、手相、面相、五行缺失,包括通过占卜方法问婚姻、前程、运势,东西宠物丢了能不能找回、取名改名等;


7. 文章标题党,主要表现为:
    1)以各种夸张、猎奇、不合常理的表现手法等行为来诱导用户;
    2)内容与标题之间存在严重不实或者原意扭曲;
    3)使用夸张标题,内容与标题严重不符的。


8.「饭圈」乱象行为,主要表现为:
    1)诱导未成年人应援集资、高额消费、投票打榜
    2)粉丝互撕谩骂、拉踩引战、造谣攻击、人肉搜索、侵犯隐私
    3)鼓动「饭圈」粉丝攀比炫富、奢靡享乐等行为
    4)以号召粉丝、雇用网络水军、「养号」形式刷量控评等行为
    5)通过「蹭热点」、制造话题等形式干扰舆论,影响传播秩序


9. 其他危害行为或内容,主要表现为:
    1)可能引发未成年人模仿不安全行为和违反社会公德行为、诱导未成年人不良嗜好影响未成年人身心健康的;
    2)不当评述自然灾害、重大事故等灾难的;
    3)美化、粉饰侵略战争行为的;
    4)法律、行政法规禁止,或可能对网络生态造成不良影响的其他内容。


二、违规处罚
本网站通过主动发现和接受用户举报两种方式收集违规行为信息。所有有意的降低内容质量、伤害平台氛围及欺凌未成年人或危害未成年人身心健康的行为都是不能容忍的。
当一个用户发布违规内容时,本网站将依据相关用户违规情节严重程度,对帐号进行禁言 1 天、7 天、15 天直至永久禁言或封停账号的处罚。当涉及欺凌未成年人、危害未成年人身心健康、通过作弊手段注册、使用帐号,或者滥用多个帐号发布违规内容时,本网站将加重处罚。


三、申诉
随着平台管理经验的不断丰富,本网站出于维护本网站氛围和秩序的目的,将不断完善本公约。
如果本网站用户对本网站基于本公约规定做出的处理有异议,可以通过「建议反馈」功能向本网站进行反馈。
(规则的最终解释权归属本网站所有)

我知道了
恭喜你~答对了
+5羽毛
下一次认真读哦
成功推荐给其他人
+ 10羽毛
评论成功且进入审核!审核通过后,您将获得10羽毛的奖励。分享本文章给好友阅读最高再得15羽毛~
(羽毛可至 "羽毛精选" 兑换礼品)
好友微信扫一扫
复制链接