代码就是最好的文档
Posted by JayXie
敏捷开发讲究的是快速响应变化,所以相对而言很反对繁冗的文档,他们认为,当情况变得很迫切的时候,才是建立文档的时候。而这份文档必须简短,以论述框架为主。而最好的文档是代码,从代码里面才能够完整的了解整个系统的结构。所以敏捷开发强调重构的重要性,一方面重构可以提高代码响应变化的能力;另一方面则是可以保持代码的清晰和简洁,让这份最好的文档能便于阅读。
每每读到一个文件数千行代码的时候,我就会更加坚信这一点,好在,至少这个文件里注释还不少:)

August 21st, 2007 at 8:32 am
与其读一个数千行的文件,我宁愿去读一个有数千个文件但每个文件不超过200行的代码……
August 26th, 2007 at 8:00 pm
俺不喜欢文件多,可能觉得cross refer 太麻烦了,呵呵
November 13th, 2008 at 12:08 pm
j83h4k146r772l3l
代码就是最好的文档