设为首页收藏本站

LUPA开源社区

 找回密码
 注册
文章 帖子 博客
LUPA开源社区 首页 IT综合资讯 查看内容

敏捷文档编制路线图

2014-7-30 11:12| 发布者: joejoe0332| 查看: 3349| 评论: 0

摘要:   介绍一下我的朋友Jane和John。  John是一家大型公司的长期分析师,负责捕获新的软件产品及现有软件产品的需求。他用SRS(软件需求规格说明书)记录所有客户对正在开发或维护的特定产品的需求。  Jane是同一 ...



项目后期文档

  由于文档是随着用户故事的实现增量编制的,在开发周期结束和产品推出后,那些技术和功能文档应该描述了所有的功能实现。


归纳

  当决定需要编制多少文档时,很重要一点是要定义多少文档是刚好够用的文档。

  图2描绘了本文中所推荐的用来决定文档编制的路线图。


  在确定了为什么、做什么、什么时候做、怎么做之后,就要用敏捷的方式定义编制文档的最佳实践,用敏捷软件开发的技术和活文档。


  表格1中列出了每一阶段推荐的文档输出内容。


 

项目前期文档

项目中期文档

项目后期(维护)文档

技术

选择的两个或三个高层次架构图

结构良好的代码,无技术基础人员易读

测试驱动开发 (TDD)

行为驱动开发 (BDD)

以代码为文档

【一次一个用户故事】

代码作为技术文档

功能

主要的史诗定义产品需要开发的主要特征

具有定义良好的用户故事,清晰的验收标准

以验收标准为文档

【一次一个用户故事】

代码作为活文档


总结


  如同我的两个虚拟朋友Jane和John所经历的一样,对任何的团队来说从传统的瀑布式到敏捷开发的过渡都是一种挑战。人们的工作方式已经沿用了几十年,当发生转变时,就会引发各种问题和质疑。


  在所有这些由团队协作方式的转变(尤其是在思想意识上的转变)而引起的问题和质疑中,文档是一个主要的问题,这是其中变化最大的一个--从开发之前编制所有文档变成同一阶段几乎不怎么写文档。


  敏捷的基本原则并没有说不需要任何文档,只是提醒团队应该注重给客户交付的价值。在编制文档的过程中,也应该考虑这一关键原则。


  所以,编制文档时请记住,只在需要的时候编制必要的文档,不多也不少。


  提醒你的团队要适时地编制恰到好处的文档。


关于作者

在大约二十年前,Ester F. Gonçalves作为一名开发人员和系统分析师开始了她的职业生涯。在最近的四年里,她决定研究IT的业务领域。她在敏捷管理的团队中从事IT业务分析工作,成为了一名敏捷爱好者,研究敏捷方法论、系统和业务分析技术,撰写和发表了多篇相关的文章和博客,偶尔在会议和研讨会上发表这些主题的演讲,并且渴求自己做得更好。

 

查看英文原文http://www.infoq.com/articles/roadmap-agile-documentation

转自 http://www.infoq.com/cn/articles/roadmap-agile-documentation?utm_campaign=infoq_content&utm_source=infoq&utm_medium=feed&utm_term=global


酷毙

雷人

鲜花

鸡蛋

漂亮
  • 快毕业了,没工作经验,
    找份工作好难啊?
    赶紧去人才芯片公司磨练吧!!

最新评论

关于LUPA|人才芯片工程|人才招聘|LUPA认证|LUPA教育|LUPA开源社区 ( 浙B2-20090187 浙公网安备 33010602006705号   

返回顶部