万事万物总是有其两面性的。
当瀑布模型把文档放在一个很重要的位置之后,随后的敏捷把文档并没有给予同样的重视。
一直都觉得敏捷的适应范围是很广的。但是最近由于所在项目文档的缺乏,让我重新思考了文档的作用。
文档缺乏的好处是,恩,真的是有好处的,因为这个客观上促进了项目组成员的沟通交流,而沟通交流的越多,一个项目组越熟悉,其可能成功的概率越大。同时,项目减少了文档维护的时间。
不好的地方,关于项目的知识是口口相传的,最后时间长了,人员变了,有些事情变成了没有定论的,有些事情(即使很重要)变成了被遗忘的,有些事情在某些人那里得到了改动,但是其他人未必知道,直到这个改动影响到他的时候,他才会更新自己这部分的知识。
结果就是没有人能真正了解这个项目,因为没有地方可以得到这个项目的全景和最新的一个快照。而我的观察是,大部分的程序员都是满足于了解和自己手头相关的事情之后,并不会主动去了解整个项目,更不要说在不知道从何着手的情况下了。
结论是,项目的文档还是很重要的,可以不要一些重型的文档,改进重型的文档维护过程,但是项目应该具有一套简洁,完备,且时时更新的文档。从而使得项目的老人,新手,管理者都有一个地方可以通过文档得到一些重要的信息。
分享到:
相关推荐
用户文档 用户手册 操作手册 维护修改建议 软件需求(规格)说明书 开发文档 软件需求(规格)说明书 数据要求说明书 概要设计说明书 详细设计说明书 可行性研究报告 项目开发计划 管理文档 项目...
当我们想要记住Java中的某些变量或数据时,便要用到Java帮助文档。Java帮助文档的使用方法。
正确理解技术文档的作用
软件过程中文档的作用及其分类 计算机导论课程的论文
java 网络爬虫,用于抓取数据。和所需资料。
其实initrd***.img是个映像文档,类似ramdisk,把一段程式打包到img里,然后在开机的时候在内存里开辟一段区域,一般是2m,释放到那里运行,都是一些初始化的程式,比如sisc_mod、ext3、sd_mod等模块和insmod、nash...
javaAPI文档作用介绍,很实用,查询方便
文档的作用与分类.doc
为了加强管理、提高工作效率, 充分借鉴前人的经验, 对文档进行规范化管理是很有必要的。 它对于保管在开发中形成的文档, 为公司积累宝贵的技术知识的财富, 为今后的软件开发工作提供第一手的宝贵资料起着重要的...
脚本化文档内容正是客户端JavaScript存在的理由,并且,本书其余的各章确实是本章的延续。第16章介绍了处理CSS样式和样式表的W3C DOM标准。第17章介绍了用于处理事件(以及实现这些任务的遗留技术和特定于IE的技术)...
软件设计文档模板 包括软件生命周期的各个阶段的文档
apache common系列包的作用以及帮助文档,里面有apache common常用包的一些功能介绍以及common系列的帮助chm文档
软件生命周期的概念与各个阶段的作用和工具
赠送jar包:spring-security-rsa-1.0.10.RELEASE.jar; 赠送原API文档:spring-security-rsa-1.0.10.RELEASE-javadoc.jar;...人性化翻译,文档中的代码和结构保持不变,注释和说明精准翻译,请放心使用。
本文首先对‘电子文档管理系统’的概念、作用及典型应用进行了介绍,然后详细介绍了电子文档管理系统的系统层次划分及接口设计与实现,并介绍了电子文档处理的一些关键技术,说明了电子文档管理系统是如何对现代...
《文档管理系统》主要用于对企业的文档进行有效管理,其主要包括基本信息、文档管理和系统设置。系统的功能性强,操作灵活,是您企业进行文档管理的最佳帮手
jdk8的api文档,通过该文档可以查看jdk8的各类方法及作用,提示学习与开发效率 jdk8的api文档,通过该文档可以查看jdk8的各类方法及作用,提示学习与开发效率 jdk8的api文档,通过该文档可以查看jdk8的各类方法及...
最新的Esper(5.0)技术帮助文档
JDK1.8 API 中文文档 apidoc 带完整索引和目录 高清完整版 CHM. 最新版 JDK 8.0 帮助文档, 带完整的索引和目录,方便查询。 附上该文档的制作软件源代码: https://github.com/subchen/javadoc.chm/ 更新了首页链接...