原创 产品设计为什么需要撰写文档?

2020-7-20 12:20 2483 68 8 分类: 工程师职场 文集: 职场实战

“说两句就可以了,为什么还需要写文档这么麻烦”?很多人都会问这个问题。确实,当我们所有人都在同一办公室工作时,随便喊两句就行了,为什么还要用文档记下每一件事情这么麻烦呢?

产品文档的价值在于,它能给整个团队一个参考点,关于这个项目中要完成的工作,产品文档提供了一个很好的依据,定义好你的产品文档,才能保证在开发过程中不会出现模凌两可的情况。当产品经理看到一篇新的文章或一个新的想法时,都会考虑增加一个新的功能。一个项目如果没有固定的目标,没有日程安排,没有预先计划好的里程碑,那项目就没有尽头。这样就没有人知道项目能得到什么收益,什么时候项目能结束。

虽然用文档来说明项目的要求是一件很麻烦的事情,但你必须要做,主要原因有:

1、有了文档你才知道目标是什么?
一个产品的目标不仅仅是你一个人的想法,产品的实现必须通过整个团队的充分配合才能完成的。如果没有文档的记录,你的产品、你的项目就会变成一个通过口口相传的“传说”,可怕的是每个人的理解都不同,每个人的口头描述又不同,这样到最后就没有一个人知道产品的真正目标是什么。只要有了文档详细地记录项目的目标,详细地记录项目的进程安排,这样产品才不会停留在产品经理头脑里不定型的图像,它变成了产品团队里每一个人都触手可及的东西。只有把一个人的想法变成整个团队的想法时,这个项目才能完美的实现处理。

2.、有了文档你才知道正在建设什么?
产品项目在早期的头脑风暴讨论中都会有很多的想法,很多的构思,如果当中没有文档记录下来,那在开发实现当中就会觉得很混乱,不知道当前要做的工作是什么?只要有了文档支持,把产品的目的和产品的规格详细地记录下来,才可能看起来像独立的功能模块;只有把要求确定下来了,才能让事情更加明细化。一个产品在开发中拥有一系列明确的要求,才能让你把责任分配的更清晰,有了明确的分工,才能提供工作中的协作效率。

3、有了文档你才知道什么是不需要做的?
产品项目在如火如荼的进行时,会有很多听起来非常诱人的功能、想法浮现出来,每一个功能、想法看上去并没有多大的工作量,但是当很多想法汇集在一起时,整个项目就失去了控制,像滚雪球一样,越滚越大,项目就会无休止的膨胀,项目的上线时间就会遥遥无期。有了文档你才知道正在建设的是什么?什么是现阶段不需要做的?有想法是好事,但有想法并不意味着马上要做。你可以把这些杰出的想法用文档记录下来,然后对这些想法进行分析研究,让它们变成你的长远计划,这才是想法的真正价值。把所有的新想法汇集起来,为产品的升级、版本更新做一个储备。

文档不仅为项目的前期和开发期提供了很好的参考点,而且能记录产品的版本历史,为每一次改版升级提供很好的对照物。虽然撰写文档和更新文档是一件很麻烦的事,但这是一个在产品开发过程中必不可少的一个重要环节。

(来源:YIXIESHI / 校排:姚晶磊)

PARTNER CONTENT

文章评论1条评论)

登录后参与讨论

FPFA兔兔爸 2020-7-24 18:55

过了 100天, 自己再看自己写的代码,就像 shit 一样。
如果没有文档,就是作者自己,也会根本看不懂的!!
文档是写给自己看的,没有文档,行吗!!

不过最好的文档,是写在代码里, 用 Doxgen 一类的工具,自动生成的才好。
孤零零的 word 文件, 谁有心情去一个版本一个版本地去刷新他呀!
相关推荐阅读
牛言喵语 2025-02-23 22:32
机器人真能照顾失能老人、遵从人类指令吗?
最近DeepSeek非常热门,市场热度甚至超过2023年的GPT,因为它由中国研发,不受互联网“墙”的限制就能使用。国内多数普通人应该都听说过GPT,但有不少人可能还没用过。上周参与一个在线话题活动,...
牛言喵语 2025-02-14 02:15
我与EET的缘分,以及2025年打算在这里分享什么?
我跟EET的相识,起源于一次国际电子工程会议,当时我是为了去听国际行业趋势和新技术产品,以公司海外英文名报名参加的,在非常不经意间,我在会场的群里发表了少许观点,没想到当场就有很多人加我微信,微信加得...
牛言喵语 2025-02-09 02:37
【工程师故事】职场沉浮数十载,从“大学生”到“大牛”
作为从技术工作起步的职场人,我的发展应该跟多数人不一样。从毕业至今数十年,进过不同行业、去过不同地区、接触过不少重点项目。总有新认识的人问我:“你后来还学了哪些专业?是怎么有跨领域能力的”?每次我都会...
牛言喵语 2025-01-22 17:10
2025年刚开始,就收到了“橄榄枝”!
临近春节,各方社交及应酬也变得多起来了,甚至一月份就排满了各式约见。有的是关系好的专业朋友的周末“恳谈会”,基本是关于2025年经济预判的话题,以及如何稳定工作等话题;但更多的预约是来自几个客户老板及...
牛言喵语 2024-11-18 19:39
国内高科技企业选领导者,用人才测评判断人才会靠谱?
为什么我要起一个这么奇怪的话题?其实这是我之前困惑的事,进一些知名的高科技企业总能遇到HR关卡 —— 人才测评,让填一个问卷,HR用计算机的结论看看我是否适岗。在我刚毕业时,在我单纯只做技术工作时,那...
我要评论
1
68
关闭 站长推荐上一条 /3 下一条