项目后期文档由于文档是随着用户故事的实现增量编制的,在开发周期结束和产品推出后,那些技术和功能文档应该描述了所有的功能实现。 归纳当决定需要编制多少文档时,很重要一点是要定义多少文档是刚好够用的文档。 图2描绘了本文中所推荐的用来决定文档编制的路线图。 在确定了为什么、做什么、什么时候做、怎么做之后,就要用敏捷的方式定义编制文档的最佳实践,用敏捷软件开发的技术和活文档。 表格1中列出了每一阶段推荐的文档输出内容。
总结如同我的两个虚拟朋友Jane和John所经历的一样,对任何的团队来说从传统的瀑布式到敏捷开发的过渡都是一种挑战。人们的工作方式已经沿用了几十年,当发生转变时,就会引发各种问题和质疑。 在所有这些由团队协作方式的转变(尤其是在思想意识上的转变)而引起的问题和质疑中,文档是一个主要的问题,这是其中变化最大的一个--从开发之前编制所有文档变成同一阶段几乎不怎么写文档。 敏捷的基本原则并没有说不需要任何文档,只是提醒团队应该注重给客户交付的价值。在编制文档的过程中,也应该考虑这一关键原则。 所以,编制文档时请记住,只在需要的时候编制必要的文档,不多也不少。 提醒你的团队要适时地编制恰到好处的文档。 关于作者
查看英文原文:http://www.infoq.com/articles/roadmap-agile-documentation |