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

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

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

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

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

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

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

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

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

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

PARTNER CONTENT

文章评论1条评论)

登录后参与讨论

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

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

不过最好的文档,是写在代码里, 用 Doxgen 一类的工具,自动生成的才好。
孤零零的 word 文件, 谁有心情去一个版本一个版本地去刷新他呀!
相关推荐阅读
牛言喵语 2024-11-18 19:39
国内高科技企业选领导者,用人才测评判断人才会靠谱?
为什么我要起一个这么奇怪的话题?其实这是我之前困惑的事,进一些知名的高科技企业总能遇到HR关卡 —— 人才测评,让填一个问卷,HR用计算机的结论看看我是否适岗。在我刚毕业时,在我单纯只做技术工作时,那...
牛言喵语 2024-11-17 01:10
翻译了一篇文章,看看我们将如何应对人口下降的未来职场?
在国内的众多自媒体上,一直在说当前国内职场发生的各种现象,还有各种剪不断理还乱的“职场梗”,有人将其归结为过度内卷,也有乘机制造焦虑的文章,更有AI将替代人类职业的各种所谓的“名人说”(传言)。但我一...
牛言喵语 2024-11-08 13:49
谈谈我从“技术”到“职能管理”再回到“技术”时的真实体验
好久没来写了,觉得有点儿愧对EET的信任。刚好最近偶遇一个年轻时梦想过的技术角色,经常进实验室,于是有点儿小感触,来写一段吧。别猜是哪家实验室,可能我就是你同事呢,哈哈(跟HR说好了不表明身份,职场上...
牛言喵语 2024-01-05 00:18
提升职场竞争力的三维法则
许茹芸的歌曲《突然想爱你》中唱到“爱到极度疯狂,爱到无法想像…在每次与你擦肩的瞬息,如今是你让我想起,那停摊已久停摆已久的心灵…”,唱出了对爱情的极度疯狂与追求。然而在事业上、职场上,也有极少数人有着...
牛言喵语 2022-01-17 12:50
中年遇到危机,应该出去创业吗?
其实,这个问题要看每个人的不同职业生涯而定,没有一个固定的答案。比方说有人是企业中/高管,并且专业领先、经验丰富,业绩也很好,那么他不论是在本身企业,亦或是跳槽去同业发展,收入都会比较稳定、比较高。但...
牛言喵语 2022-01-14 15:14
创业失败就很难回归职场了?不存在的!
后疫情时代的2021年,虽然经济和市场都在逐渐回暖,但依旧有上千家企业倒闭,其中还包括开业“有年头”、规模不小的企业。其实这个问题,在我看来,“创业”本身就是一种职场经验。创业失败,其实没什么,因为在...
EE直播间
更多
我要评论
1
67
关闭 站长推荐上一条 /3 下一条