文档，又是文档

文档，又是文档，《敏捷建模》中关于文档的一段文字，觉得非常好。

害怕失去所有的人而导致过度的文档

很多组织机构害怕失去他们的软件开发团队，因为一旦团队全部或大部分的人离开，非常重要而且常常没有几率的知识会和他们一起离开。常见的失去团队的原因有：

有竞争者从你那里掘走了团队，以便启动他们自己的项目
有的开发人员习惯性的跳来跳去，从不在任何公司久留。
在团队刚刚完成项目之后你有意解散了他们。

为了解决这个问题，高级管理层常见的策略就是要求大量的文档，他们相信一旦失去了这个团队，可以简单的组成另一个团队，并把文档交给新组成的团队。这个办法听起来不错，但在实际工作中常被证明起不了什么作用。第一，尽管文档可能对当前的情况有帮助，但新来的团队不大可能会相信它，他们宁愿通过它得到关于系统的一个“地势走向”，然后钻进代码以获得细节。换句话说，他们使用详细文档可能只是为了包含在其中的一小部分概览文档。第二，这个策略经常会变成一个自我实现的预言，因为害怕他们会离开，你强制开发人员写过量的文档，而正因为你的官僚主义、缺乏对他们的信任和缺少对软件开发的关注，他们会真的决定离开。

在这种情况下，我会和要求文档的人一起工作，尝试商议出一个更敏捷的方法。我的经验是，由简洁的概览文档和适当的契约模型支持的高质量源代码，就能为将来需要维护和增强系统的开发人员提供一个足够好的系统描述。