`
zhang_xzhi_xjtu
  • 浏览: 524468 次
  • 性别: Icon_minigender_1
  • 来自: 杭州
社区版块
存档分类
最新评论

文档的作用

阅读更多
万事万物总是有其两面性的。
当瀑布模型把文档放在一个很重要的位置之后,随后的敏捷把文档并没有给予同样的重视。
一直都觉得敏捷的适应范围是很广的。但是最近由于所在项目文档的缺乏,让我重新思考了文档的作用。

文档缺乏的好处是,恩,真的是有好处的,因为这个客观上促进了项目组成员的沟通交流,而沟通交流的越多,一个项目组越熟悉,其可能成功的概率越大。同时,项目减少了文档维护的时间。

不好的地方,关于项目的知识是口口相传的,最后时间长了,人员变了,有些事情变成了没有定论的,有些事情(即使很重要)变成了被遗忘的,有些事情在某些人那里得到了改动,但是其他人未必知道,直到这个改动影响到他的时候,他才会更新自己这部分的知识。
结果就是没有人能真正了解这个项目,因为没有地方可以得到这个项目的全景和最新的一个快照。而我的观察是,大部分的程序员都是满足于了解和自己手头相关的事情之后,并不会主动去了解整个项目,更不要说在不知道从何着手的情况下了。

结论是,项目的文档还是很重要的,可以不要一些重型的文档,改进重型的文档维护过程,但是项目应该具有一套简洁,完备,且时时更新的文档。从而使得项目的老人,新手,管理者都有一个地方可以通过文档得到一些重要的信息。
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics