admin管理员组

文章数量:1540692

2024年5月5日发(作者:)

产品小白的需求文档模板

因为开始需要相对频繁的写一些大大小小的需求文档,最近就

整理了一份需求文档的模板,文档已经做好了,就想整理一下

过程中的思路发在这里。

开始前有几点还是要说明下:

1.

因为小白刚刚毕业,文件中可能有很多考虑不周的地

方。

2.

我做的是后端产品,需要比较多的文字描述,所以用的

是Word的形式。

3.

自身的知识储备和经验不足,所以基本上都是参照很多

前辈的分享文章去整理的。

下面正式开始吧。

首先是确定整个文档的结构,基本一致。

最开始当然是封面了,这部分内容是让读者(开发、测试、老

大...)先对一些基本情况做一些了解,比如说是谁写的、什

么时候写的、现在的版本是什么...

接下来是文档的修订记录,记录好什么时候因为什么做了什么

样的版本修改,这和封面一样,都算是基础配置了~

做好这些基础配置之后,就是要确定整篇需求文档的结构了,

这方面大家基本上都是大同小异,下面说一下我整理的内容:

首先是“文档介绍”,这部分从我们自己公司内部协作的角度

讲其实是可有可无的,我为了显示自己的文档看起来专业一

点,还是把他加上了,可能这也是我们这些小白常有的心思

吧。第二部分是“项目综述”,这部分我觉得是比较重要的,

在这里一方面描述清楚这个项目/需求的背景,包括谁提的、

为什么提,一方面要通过一些图例把整个产品/需求里面所牵

涉的逻辑关系、操作流程、功能结构这些表述清楚,这些图例

不仅可以帮助读者(开发、测试、老大...)尽快的理解需

求,也能够帮助我们自己梳理思路以及在必要的时候做出一定

的调整。第三部分是“功能说明”,这部分是占用整个需求文

档主要篇幅的部分,对于后端产品来说,我们需要用足够大的

篇幅对每一个功能点做出详细的描述说明。最后一部分就是

“其他”了,这部分在我们自己日常工作的时候其实也经常是

可有可无的,同样为了显得高大上一点~~这做的这份需求文档

模板里面也还是把这块加上了。

下面是整个目录的截图:

第一部分:文档介绍

文档介绍包含“文档目的”、“阅读对象”、“参考文献”、

“术语与缩写解释”四个部分。

文档目的顾名思义,就是撰写这篇需求文档的目的,比如说要

描述些什么,为了在项目进行中起到什么作用,在模板中我摘

抄了一些套话,大家可以参考一下:

阅读对象没什么好解释的,尽可能涵盖完全就好。

参考文献的目的是为了让读者清楚我们在编写需求文档的时候

都参考了哪些文档,比如API文档之类的,开发人员可以通过

阅读我们标注的参考文档尽快的了解需求内容。

我觉得术语和缩写解释还是挺重要的,我们不管是做什么产

品,大多数的时候都是围绕一个行业去的,不管是我们产品还

是开发、测试,在接触这个产品之前,很可能对这个行业一无

所知或者知之甚少。然而我们在描述需求的时候经常会使用到

一些这个行业相关的一些名词,这个时候我们就需要事先把这

本文标签: 文档需求时候产品