童话说说技术创业美文职业
投稿投诉
职业母婴
职场个人
历史治疗
笔记技能
美文纠纷
幽默家庭
范文作文
乐趣解密
创业案例
社会工作
新闻家居
心理安全
技术八卦
仲裁思考
生活时事
运势奇闻
说说企业
魅力社交
安好健康
传统笑话
童话初中
男女饮食
周易阅读
爱好两性

PRD七坑:没有可读性的PRD都是耍流氓

10月26日 六壬会投稿
  写PRD并不是产品经理的全部工作,但却是不可少的一部分,一份可读性的PRD对一个项目团队来说是至关重要的。
  突发事件
  昨天编辑了一篇纯逻辑修改的文档,交付开发后,开发方向偏离,后台大量订单数据出错出错。
  我立马叫停开发人员,交流之后,发现开发人员错误理解了PRD文档。开发人员在阅读文档的时候直接看掉了两个字。
  后来我自己回去阅读的时候也看错了,说明我文档是不易读。所以一方面叫开发人员停下来修复数据出错的地方,一方面重新整理文档。
  下面我就介绍一下我在梳理文档过程中发现的几个坑。
  第一坑名词交流混乱
  这是昨天文档中最大的问题,因为后台是管理订单的,所以会有大量的时间结点,但是目前只有两个时间结点有自己的专属名字。其他的时间结点的叫法都是今天一个样,明天一个样。
  所以我在写文档的时候就按照自己的叫发来写文档,其中就有一系列相似名称的时间结点叫做“服务时间”、“次服务时间”、“官方服务时间”,技术同学在开发的时候,直接把“官方服务时间”的“官方”二字看掉了。
  看错后就直接对“服务时间”的先关内容进行大刀阔斧的修改,所以就导致后台订单数据错乱。于是乎经过交流,终于重新定名“服务时间”、“订单时间”、“官方时间”。
  关键词命名的注意点:
  整个团队要将关键词进行统一,最好创建规范性名词解释列表;
  关键词命名时,同一个模块、流程中的词语里边相同字的使用不要超过50;
  还有产品设计各个环节中,关键词的一致性,也是需要注意的。
  第二坑专业名称重复出现
  昨天在写文档的时候,为了使每一个名词都能精确的定位到每个点上,所以每一个名词都使用专业名称来表示,全篇PRD专业名称横飞。由于昨天写的文档是属于纯逻辑性的文档,所以大量在专业名称充斥的情况下,整篇文章的可读性极差。
  专业名称使用注意:
  同一句话中,能使用代词来代指句子中的专业名称的时候,尽量使用代词表示,因为代词更口语化,也更容易让人理解。
  如果使用代词会让整句话产生歧义,那就一定不要使用代词;
  使用代词可以增加可读性,使用专业名称可以增加准确性,所以只有在恰到好处的地方进行敲到好处的表达,才能把文档的易读性和准确性最大化。
  第三坑行文逻辑不清晰
  在写开发文档的时候,凭着直觉来写文档,在写之前并没有梳理清楚其中的逻辑,以至于最后写出来地文档逻辑混乱,各个板块互相穿插。
  在撰写文档前,首先自己要清楚整个功能的流程,这个肯定是毋庸置疑的。但是,我们在写文档的时候,可能就没有这么在意行文的逻辑,全凭自觉来撰写。
  所以在写文档的时候,不仅仅需要理清整个产品、功能的逻辑,还需要为整篇文章的结构和行为逻辑进行提前的思考,不然产出的文档可读性也很差。
  第四坑详细得臃肿
  在写PRD时,为了想一次性把问题说清楚,让程序员能一次性把文档理解透。所以会把一个问题解释得很详细,从而使得文档变得很臃肿。
  这不是认真,这其实是一种懒惰,因为想用文档砸给程序员,让他们自己去理解产品,不想和程序员进行过多的交流和文档解释。
  其实在实际工作中,我发现有就算你写得再详细,如果不进行口头介绍,程序员想把如此臃肿的文档理解清楚也非常不容易。所以,如果能用流程图来表述,就不需要长篇累述;如果能先进行产品大致的介绍,让大家先理解整个思路,就不需要文字上过于累赘的表述。
  产品文档应该做到“考虑全面,逻辑清晰,语言精练”
  第五坑文档排版不易读
  原来才开始写文档的时候,完全不知道什么排版,在无数次打磨自己的格式后,开始对排版有了一点自己的理解。
  如果说排版有什么技巧,我想可能是这几个:
  以功能划分大板块,大板块标题醒目。
  把大板块简单拆分,并用小标题区分。
  用点号罗列观点,不要写成一大段。
  对于文档排版,统一文字格式后,做好以上几点就能确保文档基本整洁和可读性。但是排版是个长期打磨和锻炼的事情,必须要经常锻炼,才能有一套自己的合理的排版风格。
  第六坑重点内容不突出
  重点加得非常随意,就会造成两个结果,重点不突出和重点不够重点。
  所以,文档中应该标记重点,但也要注意:
  重点最好为重要的动词、转折词、新名词和关键逻辑判定词等。
  重点内容不在于多,更在于精,满篇重点则是没有重点。
  第七坑不用程序员喜欢的形式写文档
  最后,特别重要的一点,也是不可不说的一点,那就是使用程序员容易理解的、喜欢的方式来写文档。
  程序员更喜欢看到能用公式来展现各个数据或者信息之间的关系;
  了解程序员编程的时候常用的逻辑,多以这种逻辑术语来写文档,这样程序员就更能理解;
  多用分句,别用连句,一个分句表达一个意思就可以了。
  能用配流程图的,千万别只写文字。
投诉 评论 转载

分析了近500位产品经理后,我得出了这些结论前些天,我从实现网上抓取了497位产品经理的个人信息,这些产品人平均工作时间超过5年,来自200多家公司,其中152人拥有BAT、京东、美团、网易、小米等一线互联网公司工作经历……【天天问每周精选】第28期:走进产品坑之转行做产品,到底行不金三银四,最近聊得最多的就是跳槽求职的话题,其中热议的除了应届毕业生如何找到产品工作之外,就是转行做产品这个话题了。很多朋友在迷茫和犹豫,我UI设计开发适不适合转产品,不了解互……【Mary带你逛起点】你可以拒绝学习,但你的对手不会俗话说:“一日之计在于晨,一年之计在于春”,好的开始是成功的一半。当你还在为可怜的年终奖郁郁寡欢,或者总是想要休息放假的时候,你的对手早已在升级自己,全力向前奔跑。2月18日起……产品经理从业指南:世界上本不该有产品经理的,上帝说有,于是就世界上本没有产品经理,老板管的事情太多了,才有了产品经理;世界上本不该有产品经理的,上帝说有,于是就有了有这么一个说法,说产品经理这个概念来自于宝洁,宝洁旗下有很多产品,……张小龙的32条产品心经无意间看到一篇《商业价值》2012年整理的张小龙分享的内容,发现很多近期被热炒的他的观点,其实是他多年前提出的,比如“贪嗔痴”。很多他的名言,其实不是他首创的,比如“我所说的都……PRD七坑:没有可读性的PRD都是耍流氓写PRD并不是产品经理的全部工作,但却是不可少的一部分,一份可读性的PRD对一个项目团队来说是至关重要的。突发事件昨天编辑了一篇纯逻辑修改的文档,交付开发后,开发方……需求量化:解读需求真伪的判断公式需求真伪的判断一直是产品圈乃至整个互联网圈最头疼的问题,没有之一。1、第一性原理需求真伪的判断一直是产品圈乃至整个互联网圈最头疼的问题,没有之一。一个个产品或创业失……如何把一款产品做死?把产品做死很简单,放弃产品经理的坚持,听从上级领导的安排,惹怒程序猿,怒怼运营喵。近来一直在思考一款产品成功的关键要素是什么,后来发现产品的成功不仅是很难复制的,而且还需……如何评价腾讯新推出的“TIM”?“老板认为员工是要管的。”“TIM”可以看做是“办公版QQ”,早在PC时代腾讯就一直在做企业软件,但是一直不温不火,到了移动互联网时代反而是阿里的“钉钉”由“IM”成功扩……野路子的产品心经之需求分析:需求来源、需求辨别、需求处理相对那些在学校一开始就为入行产品经理做准备的同学,我还真是误打误撞入行的,到目前为止发现自己很心水产品经理这个职业,为自己的好运气点个赞,能够做一份自己热爱的工作,所以每天都是……初入行PM必备:大白话告诉你计算机基础知识(第四弹)前面几期简单说了说计算机基础知识、前端知识等等,关于后端的知识,这些干货是少不了的,服务器、数据库、缓存、cookie、session等等,今天就聊聊这几点。1、服务器……产品失败的十大根本原因,任何一条都足以摧毁一个团队!在这篇文章中我想去讨论许多产品失败的根本原因。我看到在绝大部分公司用的都是相同的基本工作方法,我不禁想提醒这和那些好公司的实际工作方法相去甚远。我不得不提醒你这讨论……
铁路视频监控智能防护系统的商业需求分析Facebook设计评审,这四件事值得学习以瑞幸领券页面为例,分析后台系统从0到1的产品设计过程以为甲方很渣,是你搞不懂客户需求做的B端产品,用户不愿意用怎么办?表格改变字段时,该如何兼容历史数据?3个步骤,完成金融品牌IP化设计面向中小客户,CPC竞价广告怎么规划设计流程?B端实战:不良品处理如何为企业搭建一套体系化的BI报表(1):企业中常用的报表分电商流程中台的产品设计之:逻辑推演业务发展策略写给新手看的色彩设计入门知识浓眉陷入交易流言,洛杉矶或许才是杜兰特的归宿下船时发现可疑包裹可以自己处理吗华亭杂感其一你想知道的房产SaaS产品,都在这里七岁孩子不听管教怎么办7岁小孩不听话怎么办2023年值得关注的新车,阿维塔11,宁德时代造续写意大利的爱国少年作文新鲜川贝母怎么保存新鲜川贝母怎样保存比较好呢发面饼怎么做最简单?一碗面粉一碗水,用筷子一搅,蓬松又暄软产褥中暑的常识有哪些?如何预防产褥中暑不孕不育造影疼吗初中作文知识点介绍

友情链接:中准网聚热点快百科快传网快生活快软网快好知文好找作文动态热点娱乐育儿情感教程科技体育养生教案探索美文旅游财经日志励志范文论文时尚保健游戏护肤业界