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

2020-7-20 12:20 859 42 7 分类: 工程师职场 文集: 职场实战

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

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

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

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

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

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

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

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

文章评论1条评论)

登录后参与讨论

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

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

不过最好的文档,是写在代码里, 用 Doxgen 一类的工具,自动生成的才好。
孤零零的 word 文件, 谁有心情去一个版本一个版本地去刷新他呀!
相关推荐阅读
Mr.牛 2020-09-21 12:59
其它行业如何看待龙湖的“家文化”事件?
最近有网文提到龙湖地产郑州公司的事情,9月2日,一位员工在龙湖地产内部论坛上留言:“来到龙湖的第二个月,也迎来了第一个生日,这短短一个月时间让我感受到了完全不一样的房地产氛围,处处充满‘仪式感’。情人...
Mr.牛 2020-07-27 14:07
从2020这一波“副业”热潮想到的...
最近有关“副业”话题仿佛是一夜春雨袭来,我在多个网上平台上都看到有人问、有人答、有视频、有晒富。以至于周围人都在说这个话题,仿佛守着一份主业、没有一份“副业”,就像是跟不上时代的步伐、不够新潮似的。其...
Mr.牛 2020-07-27 13:53
转发:用户为什么总是抱怨?
很长时间以来我(指原作者)一直积极参与Gnome项目。经过这些年,我看到过和听到过很多批评和赞扬,但有一种我却从来没有弄明白。如果项目中的某个功能被删除,总有人会出来抱怨。有时是某个功能被更好的方案代...
Mr.牛 2020-07-09 08:42
年轻时在职场上学到的最有用的习惯
因学历起点不完美,我年轻时的职业道路比较曲折,但是现在回想起来那些机会点确实都挺不错,以前则觉得实在是太不合理了!经历过一些对能力要求很高的企业,他们对学历反倒不看重,一些公司规定给我留下了深刻的印象...
Mr.牛 2020-07-06 11:55
我所经历的职业规划两三事
“职业生涯”融会贯通于每一个成年人的人生道路,它也能为工作与生活带来更深层次的意义。最近我在Linkedin上参与了很多问答,人气比较火爆,其实这也是在我意料之中的,如果我的回答不热门,那我反倒会觉得...
广告
EE直播间
更多
我要评论
1
42
广告
关闭 热点推荐上一条 /5 下一条