[讨论] 软件文档的眼球吸引力。。。? [发表于 2004/1/30] 状态 开放帖 浏览量 4596 |
|
写一篇文章,需要明确他的目标读者,软件文档也一样。。 但是,我发觉团队中不少辛苦形成的软件文档(包括需求规格说明书;类模型文档。。)往往迷失了读者,或者根本就很少有读者,或者读者不想读。。。。那么反观回来,我们花费的劳动有价值吗?我们这样辛苦的去做文档,最后却成了没有读者的文字垃圾?? 有一个例子:我朋友的团队中,做了一份详细的需求调研报告(从调研到报告形成,大约2个月,3个人),足足有差不多70页,还辛苦的装订了N份,分发给客户,一个月过去了,竟然没有一个客户从头到尾看过,好多客户看到这厚厚的一本,就怕了,连翻都没翻。。。这6个人月+若干的装订,还有等待的时间。。。怎么算?? 文档有没有眼球吸引力,在于它本身的含金量有多少,还有是否使用了读者习惯且人性化的方式表现。。。 这也让我很慎重的选择软件过程中的文档,而且对内容结构进行认真的裁减,写有用的文档,无用的文字,段落,文章,见一个杀一个。。。用简洁的方式表现,能用图形的尽量不用文字,能用动画的尽量减少文本。。对于过期的文档定时整理和销毁,保证文档的眼球吸引力。。。。
|
-------------------------------------------------------------------------------------------------------- ****有问题,找IT项目管理****... ITPM在线:QQ群-8721636;BB群(msn)- group3730@bbqun.com ;高级M群(msn)- group151431@xiaoi.com (PMP+5年以上PM经验,需验证!) One Aim,One God,One Life. || 最爱:偶家阳阳 || 博客:愚人camer || MSN:camellxr@hotmail.com ![按此在新窗口浏览图片](http://cache26.51.com/photo1/31/e1/cq88/1152202240661.gif) >>> 由论坛统一发布的广告:
|
|
楼主
camer
![](/Images/members/nophoto.gif)
职务 无
军衔 上将
来自 广东
发帖 2745篇
注册 2003/3/3
PM币 14759
经验
|
|
Re:[讨论] 软件文档的眼球吸引力。。。?
[回复于 2004/2/13]
|
很好的主题....确实存在于这种现象.up
|
-------------------------------------------------------------------------------------------------------- 让生活如涓涓细流,欢快,轻盈,歌唱着一路欢腾下去... 让工作成为我生活的图腾... MSN:ruddyli@hotmail.com
|
|
1楼
ruddyli
![](/Images/members/200592710722.jpg)
职务 无
军衔 上校
来自 北京
发帖 1764篇
注册 2003/8/28
PM币 10623
经验
|
|
Re:[讨论] 软件文档的眼球吸引力。。。?
[回复于 2004/2/15]
|
同感,不过辛苦不会白费,至少厚厚的文档可以说明写文档的人很认真,可以说明出文档的公司很认真,这也许才是客户比较关心的问题。
|
|
|
2楼
alicks
![](/Images/members/nophoto.gif)
职务 无
军衔 三等兵
来自 不告诉你 :)
发帖 18篇
注册 2004/2/9
PM币 180
经验
|
|
Re:[讨论] 软件文档的眼球吸引力。。。?
[回复于 2004/2/18]
|
完善的文档的每一部分一定有它的目的和作用,只是根据受者和项目的特点进行裁减。
|
|
|
3楼
mlwang
![](/Images/members/nophoto.gif)
职务 无
军衔 下士
来自 上海
发帖 120篇
注册 2003/2/16
PM币 584
经验
|
|
Re:[讨论] 软件文档的眼球吸引力。。。?
[回复于 2004/2/19]
|
项目文档最好做好规范,简单明了,主体明确,同时最好能让客户签字认可。方便以后将资料移交给售后服务部。
|
|
|
4楼
djzqcf
![](/Images/members/nophoto.gif)
职务 无
军衔 一等兵
来自 不告诉你 :)
发帖 31篇
注册 2004/2/19
PM币 86
经验
|
|
Re:[讨论] 软件文档的眼球吸引力。。。?
[回复于 2004/2/19]
|
个人觉得文档只是当初设计的时候的一下想法的概要。 而且是后续交流的一个依据平台。 如果没有一个文档,项目中的交流将会非常的困难。 而且,作为it 项目变更很多,文档不应该非常的详细, 简单,概要就好了。
|
|
|
5楼
peterchen
![](/Images/members/nophoto.gif)
职务 无
军衔 三等兵
来自 浙江
发帖 0篇
注册 2007/12/8
PM币 0
经验
|
|
Re:[讨论] 软件文档的眼球吸引力。。。?
[回复于 2004/2/27]
|
我想作为用户方,谁也没有精力把一厚厚没有一点情趣的文档看完,这需要实践和培训,只有在应用中遇到不会的时候,他才会想起你的文档来,你说是吧,文档只是用户用来应急,或一种保存的必要吧。但也是项目中的必须品之一。
|
|
|
6楼
lyf9199
![](/Images/members/nophoto.gif)
职务 无
军衔 三等兵
来自 山东
发帖 0篇
注册 2007/12/8
PM币 0
经验
|
|
Re:[讨论] 软件文档的眼球吸引力。。。?
[回复于 2004/2/27]
|
任何事情的规范化都是有一个过程的,不能因为用户的状态,而影像贵公司软件工程的规范化。详细的需求规格说明不论对本公司和客户都是很有意义的。在一定程度上,对用户施加压力,可以解决此类问题。
|
|
|
7楼
rollli
![](/Images/members/nophoto.gif)
职务 无
军衔 三等兵
来自 北京
发帖 1篇
注册 2003/2/19
PM币 116
经验
|
|
Re:[讨论] 软件文档的眼球吸引力。。。?
[回复于 2004/3/18]
|
项目管理 类文档当然要简洁、明确,但标书、方案类文档如果不厚似乎直接没有吸引力了,这也是解决方案精华在前段的分析及解决方法,而后期4/5的功能介绍少有人问津,却始终勤粘不已的原因,因为在用户看来,没有厚度=没有深度=没有水平。
|
-------------------------------------------------------------------------------------------------------- 我需要沟通
http://storm.mypm.net MSN:weikailiu@hotmail.com
|
|
8楼
storm
![](/Images/members/200681484811.jpg)
职务 无
军衔 少校
来自 北京
发帖 401篇
注册 2003/11/18
PM币 4068
经验
|
|