敏捷开发讲究的是快速响应变化，所以相对而言很反对繁冗的文档，他们认为，当情况变得很迫切的时候，才是建立文档的时候。而这份文档必须简短，以论述框架为主。而最好的文档是代码，从代码里面才能够完整的了解整个系统的结构。所以敏捷开发强调重构的重要性，一方面重构可以提高代码响应变化的能力；另一方面则是可以保持代码的清晰和简洁，让这份最好的文档能便于阅读。

每每读到一个文件数千行代码的时候，我就会更加坚信这一点，好在，至少这个文件里注释还不少：）