原创 关于软件文档化的一些想法。收藏

新一篇: 实战OO--诚征评论 | 旧一篇: 给诸位大师的一个建议

国内关于软件文档的问题一直都有讨论,而声音主要聚集在两个方面:

1)软件文档很重要,它能够规范过程,保证组织利益

2)软件文档很费劲,它更新维护麻烦,会拖累组织。

而笔者发现大多数人、企业都处于“在思想上认可第一种思想,而在行动方面却不得不使用第二种路子”,面临这样的问题,笔者找到了一种折衷的解决之道,在此与大家共享:

在日常的交流讨论中,将原始的资料进行保存(例如纸上的草稿通过扫描仪扫描到电脑中,而在白板上的东西则将其用数码相机拍下来存入电脑),然后统一进行配置服务器。

对于一些重要的内容,再进行文档化,将这些资料做为附件,则可!

试一试,你一定会喜欢。

发表于 @ 2004年07月13日 14:28:00|评论(loading...)|编辑

新一篇: 实战OO--诚征评论 | 旧一篇: 给诸位大师的一个建议

评论

#yayv 发表于2004-07-14 12:02:00  IP: 211.160.88.*
可维护性还是不高。而且信息的冗余很大。如果缺乏整理,或陷入垃圾信息之中。
#yayv 发表于2004-07-14 12:04:00  IP: 211.160.88.*
还是喜欢纯文本+xml+html的文档组织方式。
最讨厌的就是word文档了,可是又无可替代。
#fjxufeng 发表于2004-07-14 14:17:00  IP: 220.160.110.*
对于维护性而言,我想解释一下:
1)对于重要的东西,还是应该整理的。
例如:重绘一张清晰的图、用纸+笔或工具软件
2)对于整个文档的管理还是需要计划的。
编号、配置管理。

有兴趣可以细节交流。
#lemonna 发表于2004-08-27 16:28:00  IP: 221.6.17.*
对啊,“纸上的草稿通过扫描仪扫描到电脑中”,我怎么没想到呢!
谢谢了,:)
#pcera 发表于2005-07-04 16:00:00  IP: 61.186.252.*
我晕,你不是在开玩笑吧!!
发表评论  


当前用户设置只有注册用户才能发表评论。如果你没有登录,请点击登录
Csdn Blog version 3.1a
Copyright © 徐锋