代码就是最好的文档

Posted by JayXie

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

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

3 Responses to “代码就是最好的文档”

  1. ZLP Says:

    与其读一个数千行的文件,我宁愿去读一个有数千个文件但每个文件不超过200行的代码……

  2. FB Says:

    俺不喜欢文件多,可能觉得cross refer 太麻烦了,呵呵

  3. Kipp Farrell Says:

    j83h4k146r772l3l

    代码就是最好的文档

Leave a Reply