敏捷文档编制路线图概述

敏捷文档编制路线图概述2016-02-29 infoq 译：李清介绍一下我的朋友Jane和John。

John是一家大型公司的长期分析师，负责捕获新的软件产品及现有软件产品的需求。他用SRS（软件需求规格说明书）记录所有客户对正在开发或维护的特定产品的需求。

Jane是同一家公司的开发人员。她通常接收John的软件需求规格说明书（SRS），而后开始对要实现的内容进行技术分析和设计。完成分析之后，她就开始写代码实现。

我的这两个朋友John和Jane的需求文档和设计文档都需要经过审批；对于John来讲，把需求文档发给Jane之前需要经过审批，而对Jane来讲，则是在开始写代码之前要经过审批。

最近，John和Jane所在的公司采用了敏捷方法来作项目管理和软件研发，这使得他们的工作方式发生了改变。不需要制定大量的前期需求和设计，需求说明书和开发都被切成了小块的信息，摒弃了使用多年的大篇幅文档。开发人员的开发方式也发生了变化，鼓励像实现之前先做测试设计和用较长的名字来命名函数等这样的做法。

不出所料，John和Jane提出了一大堆的问题：

如果我们无法提前知道要开发什么，那我们怎么开始开发呢？

那些功能资料如果不记录在往常所用的SRS中，那么记录在哪里呢？

我们如何了解要开发的所有详细信息？

用于未来维护的说明文档和代码放在哪里？

如果没有写文档的阶段，那么我们什么时候写文档呢？

在过去十年中，敏捷方法在项目管理和软件开发中的应用经历了迅速发展的阶段，并预计将持续地增长。在向敏捷过渡的过程中，看似宽松的开发方式完全不同，做事不再那么传统，为此，世界各地的许多人都会和John、Jane一样抛出如上同样的问题。

当公司开始过渡到敏捷理念的过程中，一些工作方式的差异都与文档有关。

本文将重点讲述为什么、什么时候、如何以及在哪里编制技术和功能文档。