敏捷中的文档

我们听到敏捷开发中的文档都内容比较简练,篇幅相对比较少. 敏捷中有句名言是"个体和交互 胜过 过程和工具可以工作的软件 胜过 面面俱到的文档"。

 

这句话说的有道理，但是容易给人们造成一种误解，就是文档的书写在敏捷开发中的地位很低，文档不需要写的太丰富，只要有足够的“点”，能保证软件如期交付，保质交付就可以了。

 

个人认为文档的完整性，专业性对软件开发和持续的软件团队发展过程起着知识积累，能力展示，软件开发中的文档的书写是单凭个体的能力无法达到要求的。敏捷提倡人与人的互动，但人的每次互动是不断的耗费人力和时间成本的，并且质量不得保证。而文档是持续完善的，并且这种方式的知识传递不受人力成本的限制，在项目的交接和持续时刻也会更有效。

 

文档的简练是在项目时间紧迫的情况下，能做到文档的简练是实属不易的。但项目总有停歇期阿。适时地把文档补充完成，修改文档，让文档符合标准（专业地表达与专业的格式，内容完整性和准确性）是团队要做到的事。

 

做事就要追求更好，不要被那句敏捷名言所误导，其实它传递出来的信息是告诉人们要务实，要识当下的实务，但并不是说我们做事的态度是图“省事”。

 

做到文档的简练要求人先有能力写出完整的专业的文档， 因为只有具备了这种“从薄到厚”的能力，才有可能达到”从厚到薄“的水平。

 

再谈这句话："个体和交互 胜过 过程和工具可以工作的软件 胜过 面面俱到的文档"。 要理解好这句话需要知道敏捷的背后是什么，为什么现在的人提倡敏捷。

 

以前包括现在，我们大部分人就是实干，埋头苦干。在这个实干的过程中有些事情是可以简练的，可以优化的，就比如写文档，就比如冗长的会议，就比如开发与测试的不同步，就比如做需求的方式与缺少反馈，就比如对新需求新变化的适应能力的强弱。这些可以被优化，改善。那么我们所说的敏捷就是为了到达优化、改善的目的，称为”精益“。

 

那么如果理解了这点，我们不难发现敏捷的背后其实还是要实干。没有实干，是无敏捷可谈。在此，我们常常犯的错误就是只重视如何去敏捷了，而忽略掉一些实干的。所以文档最终还是要丰富起来，完善起来。这就是我今天想表达的意思。