跳至主要內容
  • Hostloc 空間訪問刷分
  • 售賣場
  • 廣告位
  • 賣站?

4563博客

全新的繁體中文 WordPress 網站
  • 首頁
  • 技术需求文档,应当这么写
未分類
13 2 月 2021

技术需求文档,应当这么写

技术需求文档,应当这么写

資深大佬 : vansenb 3

需求文档是我们在开发中常用的一类沟通方式和媒介,它承载着需求方的期望,同时也标记着一系列事项的生命周期。

不同部门、不同受众的需求文档各异,例如运营人员向产品人员提出的活动需求、产品人员向开发人员提出的功能需求、开发人员向运维人员提出的服务支撑需求、各小组内部同事之间互相提出的需求等等。

为何需要需求文档?

大部分场景下需求提出方和需求承接方都存在不小的信息差,需求提出方常用的语句是“我需要做成这样”、“越快越好”、“怎么用你不用管,给我就行”、“这不是我想要的”、“我想要的其实是那样”。

一个人经常否定自己的选择和言语的现象是存在的,无论有意或无意,但这无疑会耗费双方的时间和精力。需求文档不仅可以作为双方沟通过程中的清单,还可以作为双方选择和执行的日志,有了需求文档,就能够避免因前后矛盾导致空耗的问题。同时,需求文档可以清晰地体现参与人员的劳动成果与劳动价值,是自我总结的良好依据。

需求文档通用模板参考

一百种需求有一千种提法,但需求中的事项相差却无几。这里给出了一份需求文档模板,大家可以将其用在工作当中,作为不同人员之间的信息传递媒介。

要注意的是,需求和执行是双生相伴的,因此这里的下面这份参照文档与其说是需求文档,不如说是任务执行记录,因为它记录着这个任务从产生到执行完毕的完整生命周期。

技术需求文档,应当这么写

为了方便大家理解,文档选用不同颜色来帮助我们区分阶段,其中:

大佬有話說 (17)

  • 資深大佬 : YouLMAO

    光看你需求等级是 abc,不是 p0,p1 就知道你不是 bat 的,瞬间没看完

  • 資深大佬 : learningman

    单链表反转都不会就能面阿里巴巴的吗
    这也太。。。。

  • 主 資深大佬 : vansenb

    @YouLMAO ABC 也好,P0123 也好,都是为了表示重要紧急程度,团队内部设定的代号,写 P 就一定厉害吗?

  • 主 資深大佬 : vansenb

    @learningman 是啊,所以这不就没通过吗

  • 資深大佬 : Lemeng

    有点长。很详细

  • 資深大佬 : YouLMAO

    @vansenb 意思是尽量向大厂借鉴,举个例子,街头煎饼果子说我要拿米其林三星,我的收费要比北京国宴总厨高,至少你要先尝尝三星的饭菜

  • 資深大佬 : leonme

    @vansenb 主要是技术名词对齐,减少沟通成本 2333

  • 主 資深大佬 : vansenb

    @YouLMAO 你这里的例子不恰当,不过意思我明白了。我要写成 P,万一评论区又有人说干嘛不写 ABC 呢,简单直观。我看你也不是故意吐槽的,和谐一些。

  • 資深大佬 : humansjl

    提问主,这份文档由哪个岗位的人主导编写呢?

  • 主 資深大佬 : vansenb

    @humansjl 技术需求文档是给开发者看的,由技术部门的负责人主导是优选。写完一个版本后可以叫上产品互通一下,后续要求技术和产品强制执行,就能够落地了。

  • 資深大佬 : GM

    图裂了

  • 資深大佬 : stevenkang

    “团队内部可以定义统一的需求等级”

    于是明明有 P0 、P1 、P2… 统一的优先等级不用,我们重新创造一个 A 、B1 、B2…

    有点迷惑,这到底是为了统一团队的名词理解,还是为了啥。建议造名词前先了解行业惯例,避免增加额外的名词理解负担。

    另搜索了一下:P=priority

  • 資深大佬 : jmyz0455

    好东西。

  • 資深大佬 : stupil

    用户层面的需求和技术层面的需求不是一个概念。
    首先要定义一下,这是谁写的需求文档,产品还是技术?
    另外,需求是那个层面的,用户需求、开发需求还是运维需求?

    例如: 当前线上 Nginx 配置文件是否需要改动

    如果是后端需求,不满足是否会造成业务需求的不满足?

  • 主 資深大佬 : vansenb

    @stevenkang 既然知道 Priority,也知道 P0 、P1 、P2,那团队内部就选用这个就好了。灵活变通一下,不要杠。

  • 主 資深大佬 : vansenb

    @stupil 这个只是参考模板,具体的可以按照自己公司的业务进行调整。不是说这一套可以满足所有场景,仔细看一下文章哈

  • 資深大佬 : stupil

    所以对你们的场景 你应该叫事务或者任务管理。

    提出所需要的任务,任务的目的 和期望的结果,以及外围相关的(任务类型、任务相关人等)

文章導覽

上一篇文章
下一篇文章

AD

其他操作

  • 登入
  • 訂閱網站內容的資訊提供
  • 訂閱留言的資訊提供
  • WordPress.org 台灣繁體中文

51la

4563博客

全新的繁體中文 WordPress 網站
返回頂端
本站採用 WordPress 建置 | 佈景主題採用 GretaThemes 所設計的 Memory
4563博客
  • Hostloc 空間訪問刷分
  • 售賣場
  • 廣告位
  • 賣站?
在這裡新增小工具