实用制品文档的转变

　　传统的文档驱动的方法浪费了大量的工程时间来开发、润色、编排、评审、更新和分发文档。为什么？文档对过程来说变得如此重要，是因为以下几方面的原因。首先，需求规格说明或设计没有严格的工程方法或语言，因此，用专门的文本和图形表示的书面文档是默认格式。其次，传统的实现和实施的语言极其神秘，而且极无组织，为了将软件结构和行为的细节呈现给其他感兴趣的评审者（测试员、维护员和经理），需要一种人类更易于阅读的格式。或许最重要的是，软件进展需要“可靠地”加以评估。文档代表了一种演示进展的有形的但易误导的机制。
　　在有些领域，文档驱动的方法在过去的30年里已经退化为过程改进的主要障碍。文档的质量变得比它所描述的工程信息的质量还要重要。同时，通过抽象描述的人工评审对质量进行评价是一个相当主观的过程。许多工作消耗在评估单维的表面问题上，而很少注意那些推动构架质量的多维问题，如性能和适应性。
　　文档的生产周期、评审周期以及更新周期，还把极其明显的、正式的进展快照注入到进度表中，因此引入了更多的进度依赖性和同步点。例如，如下所示的场景在大型的国防项目中是常见的：用一个月时间准备一个设计文档，将文档交付给客户评审，等待一个月接收反馈意见，然后用一个月时间对意见做出回答并变更。随着许许多多这样的几个月的文档评审周期要管理、安排和同步，类似的项目需要五年的开发生命周期才能完成，就不值得惊奇了。冗长而又非常详细的文档一般被认为能够演示更多的进展，但在生命周期的后期却导致不成熟的工程细节并增加了废品和返工。
　　更有效的方法是将这种文档工作转向改进信息源的严密性和可理解性，并允许用快速浏览和导航工具对本地信息源进行在线评审。这样的方法可以消除过程中巨大的、无效率的废品和返工因素，并允许每个关心进化中的在线制品的人员直接进行持续的评审。