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