产品文档如何撰写,修订记录和需求文档的记录?

营销圈公众号引导关注

在产品未进入生产性开发之前,所做的所有工作成果都是以文档的形式进行体现的,是新产品开发最重要,也是价值最大的工作内容,包括商业文档、市场文档、设计文档及功能详述,如图5-11所示。从广义上来讲,产品文档内容包含有产品的战略和战术,战略是指:目标市场、客群定位、竞争对手、产品概念、价值主张、产品定位、商业模式等;战术是指竞争策略、产品创意、创新设计、产品结构、核心业务流程、具体用例描述、功能及内容描述等。

产品文档如何撰写,修订记录和需求文档的记录?

图5-11 产品设计相关四大文档

1. 商业文档

BRD商业需求文档是指基于商业目标或价值所描述的产品需求内容文档(报告),其核心的用途就是用于产品在投入研发之前,由企业高层作为决策评估的重要依据。作为报告的撰写者,你必须让高层明白,你的报告中将展现出怎样的商业价值,如何用有力的论据来说服企业对你这个项目的认可,并为之慷慨的投入研发资源及市场费用。如果说PRD的好坏,直接决定了项目的质量水平,那么BRD的作用,就是决定了你的项目的商业价值。优秀的BRD文档,可以让决策层充分被你的报告观点所吸引,或许财务主管会因为报告呈现的低投入高产出的经济效益预测而蠢蠢欲动;或许技术主管会因为项目的牵涉面广泛而头疼不已;又或许公司的VP之流因之报告而看到了未来一年业绩的飞速发展的广阔前景……

BRD需要产品经理(产品设计师)像对待PRD一样,充分应用市场调查、用户研究、需求分析等各种设计手段来充分阐述报告, 内容和格式要求够直观、精炼,要点突出,一般比较短小精炼,没有产品细节。产品经理通常需要向上汇报商业文档,供决策层们讨论,汇报会议主要内容如下。

会议开始,产品经理首先要给与会的领导介绍一下产品要做什么吧?(解决什么问题或满足什么用户需要)

为什么要做?谈谈背后的原因(背景、市场空间、竞争对手、环境)

打算怎么做?(产品规划、模块规划、研发计划、运营计划)

需要多少资源?(人力成本、软硬件成本、运营成本)

最终能获得什么收益?(带来收入、带来用户、扩大市场、占有市场先机、满足未来三年战略规划等)

做这个有没有风险?(开发失败?失去市场机会?失去先机?竞争不过对手?没有带来收入?没有带来用户?与公司战略背道而驰?)

2. 市场文档

MRD市场需求文档是产品项目由“准备”阶段进入到“实施”阶段的第一文档,其作用就是“对某个产品进行市场层面的说明”。该文档中,侧重的是对产品所在市场、客户、购买者、用户以及市场需求进行定义,并通过原型的形式加以形象化。这个文档的质量好坏直接影响到产品项目的开展,并直接影响到公司产品战略意图的实现。该文档在产品项目中是一个“承上启下”的作用,“向上”是对不断积累的市场数据的一种整合和记录,“向下”是对后续工作的方向说明和工作指导。文档包含主要内容如下。

l市场说明:目标市场、市场规模、市场特征、未来3~5年的发展趋势,现在市场存在的问题和机会。一般来说,这里会得到一个比较有市场商业价值的结论。

l用户说明:目标客群的共性分析,常用用户特征(要求准确:年龄段、收入、地区、学历),通过用户画像建立虚拟用户角色:形象化,用户名称,用户技能、与产品相关的用户特征,演示性的场景,用户在时间、地点,完成的某个事的故事。从技术层面剖析市场,洞察用户心理案例分析[张乐飞1] (动机和目标是不一致的)影响用户使用的主要因素。

l产品定位:我们用什么样的产品满足用户或用户市场;针对什么用户,做什么事。

l产品价值:解决目标市场、用户的核心需求(核心价值优先级最高)。

l产品架构:整体结构,不是功能结构。是产品的核心目标,市场定位,产品定位的直接体现。

l产品路线图:以时间为节点,任务为导向。

l产品功能性需求:用户注册、留言等等。

l非功能性需求:有效性、性能、扩展性、安全性、健壮性、兼容性、可用性、用户体验等。

3. 设计文档

PRD产品设计文档是把我们想做的东西变成一张清晰明了的“图纸”,让研发人员看到这张“图纸”就知道我们要做啥,需要做到什么程度,大概需要什么技术,并能对成本进行一个预估。不同平台和不同行业的产品的设计文档有所区别,但思想都差不多。这里以网站为例,设计文档一般包括网站结构图,线框图和网页描述表。产品设计文档伴随着产品整个生命周期,帮助产品团队与研发团队和高层领导达成共识,进而明确研发计划和指导研发过程。不同的公司、不同的产品会有自己不同的要求和模板,但在这里我想提醒一些大家需要注意的地方。

l保持简短:对于产品设计文档,保持简短很重要,因为越是简短,包含的错误越少,同时更容易阅读,同时也越可能带来简洁的设计。但是一定要在穷尽的基础上简短,不要为了最求简短而忽略一些细节,在产品设计中,每一个小细节对产品的质量来说都很重要。所以一定要仔细思考,认真推敲。

l消灭错误:错误的文档会花费研发团队大量的时间,甚至会导致大规模的改动,这时对研发来说没有谁会很爽,一个个都恨不得把你给撕了。有点夸张了。但心里面绝对是一万个“操尼玛”!同时也会让产品团队在研发团队面前抬不起头。当然,也不用太想不开,毕竟没有错误的文档和没有错误的代码一样,都是不存在的,我们需要做的是尽可能的消灭错误,让错误能在可承受范围内。错误有很多种,有产品逻辑错误(最致命的),有多个需求相互矛盾的错误,还有错别字等层面的低级错误。在撰写产品设计文档的时候,产品团队因对应产品逻辑进行充分的讨论和测试,最终要组织评审会议,采用审核通过的方式把关。

l别对他人(主要是研发人员)的工作指手画脚:也就是说在设计文档中不要提一些技术性的东西。比如:将其存入数据库的一个新表中,连续存放,以优化查询效率。别提之类的需求,你很可能犯一些细节上的错误。己所不欲,勿施于人,别人在你的领域内指手画脚你也会感到很烦。如果你是个技术专家,可以私下沟通,别把应该写在技术文档中的内容写在设计文档里。

l用适当的方式表述需求:选取适当的方式展现特定的信息,是产品经理的一项重要技能,面对研发团队的时候要用到,面对最终用户的时候也会用到,怎样去表现我们的需求让研发或客户能快速有效的理解是相当重要的,不仅可以提高工作效率,还可以避免很多因理解不当造成的错误。因理解不一致这种错误是很常见的,和不同领域类的人提需求理解不当更是家常便饭了,选用适当的表述方式是相当重要的。比如,用叙述性文字说不清楚我们就用表格或其他的,有时候还需要选择一些图形工具。

l使用肯定的语言:在产品设计文档中,使用肯定的、确切的语言,切勿出现“也许,可能”这类词语。我们最终提交的文档内容都是确切的,可被执行的,含糊不清的东西一定要全部消灭掉。如果有吃不准的东西,就放在内部充分讨论后在做决定。

l切勿忽视沟通:很多产品新人在写产品设计文档的时候,独自埋着头写,写好了之后再出去沟通,这样文档有99%的概率会被大幅度修改,这等于是在做无用功,所以在写设计文档的时候千万不要忽略和团队沟通。

4. 功能详述

FSD功能详细说明定义产品功能需求的全部细节,这是一份可以直接让工程师创建产品的文档。FSD建立在BRD、MRD和PRD的基础上,从这步就开始往开发衔接了,产品UI、业务逻辑的细节都要确定,细化文档并保持更新。功能需求是所有的产品功能的描述和规划,以互联网产品为例包括以下内容。

l简要说明:介绍此功能的用途,包括其来源或背景,能够解决哪些问题。

l场景描述:产品在哪种情况下会被用户使用,就是用户场景模拟。这也是产品经理讲“好”故事的必备条件。

l业务规则:每个[张乐飞2] 产品在开发时都有相应的业务规则,将这些规则清晰的描述出来,让开发、测试人员能够直观的明白该规则,且没有产生歧义。业务规则必需是完整的、准确的、易懂的。业务规则的描述上如果涉及到页面交互或者页面的修改,建议给出页面的草图或者页面截图在图上说明要修改的内容。另外也建议对页面的输入框、下拉框的内容格式、长度、控件之间的关联性做出说明,什么时候可见,不可见,灰掉或点亮的条件在文档中都给出说明。方便阅读者理解业务规则。

l界面原型:如前所述,涉及到页面交互的部分,产品经理需要设计页面原型。原型设计通常需要产品经理和UI设计师一起来完成。建议的做法是,产品经理可设计一个页面框架,将该页面要呈现的字段及其特征以及页面要使用的场景向交互设计师解释清楚。之后交互和视觉设计师完成产品的原型设计。

l使用者说明:对产品使用者做出说明,可融入简要说明中。

l前置条件:该需求实现依赖的前提条件。比如,上传照片时,需要存有图像的文件。

l后置条件:操作后引发的后续处理。

l主流程:把主流放在最后是有道理的,结合上面所说的,做出主流程说明,对每个功能流程走向分点说明(这是非常重要的)。

看过很多的PRD(包含FSD),文档中对既没有前提条件,也没有后置条件,只对主流程做了说明,但是在描述主流程时却没有描写主流程中每个功能流程的各种走向,只有一个主走向,让人感觉PRD成了操作手册。事实上,对分支的介绍是非常重要的,开发和测试中提出的各类问题均与对分支的定义不明有关。一个合格的PRD不仅要描述主流程,同时对分支流程所出现的各类问题都要做详细阐述并给出解决办法。PRD的特征一定是明确的、全面的阐述需求及各类异常情况的处理而不是等到开发和测试阶段发现问题后再给以答案(虽然PRD不可能百分之百地覆盖所有的可能,但是最大化的思考所有的业务问题是编制PRD时必须遵守的原则)。另外,在描写功能需求时给出的办法中不能出现“可能”、“或者”等词,一定是明确的,准确的描述。如果有别的方案,建议写入“可选方案”,在产品构建的早期可选方案可以为功能实现提供更多的选择,当方案确定后可在文档中注明本次使用了哪种方案。

好了,这篇文章的内容营销圈就和大家分享到这里,如果大家对网络推广引流和网络创业项目感兴趣,可以添加微信:Sum8338 备注:营销圈引流学习,我拉你进直播课程学习群,每周135晚上都是有实战的推广引流技术和网络创业项目课程分享,当然是免费学!

版权声明:本站部分文章来源互联网用户自发投稿,主要目的在于分享信息,版权归原作者所有,不承担相关法律责任。如有侵权请联系我们反馈邮箱yingxiaoo@foxmail.com,我们将在7个工作日内进行处理,如若转载,请注明本文地址:https://www.yingxiaoo.com/131194.html