现在是什么时代了?为什么像报表这种项目型的短周期开发还需要详细的设计文档了?代码不能够当作文档么?我真的很不理解。说是为了新来的人考虑?新来的人如果看不懂代码我觉得有文档也没有什么意义吧?
文档和代码描述问题的角度和方式完全不同。我趋向于说文档来描述一个大略的东西,不可能在文档期间搞定所有的细节,并保证以后不会产生偏差。也不能保证用户的需求永远一成不变。其实我不担心用户变,我10年的经验已经足以支持我写出容易修改和维护的代码了。文档比代码更容易腐朽。
我是一个代码至上的人,比较喜欢读和写代码。我认为唯一能保证软件质量的只有代码以及写代码的人。如果我是领导,我会不遗余力的抓我们的代码质量。我会找合适的人员组成核心开发团队,负责写抽象层级的代码尽可能的封装用户的变化和一些永远也不会变化的事情(比如数据库访问等),这些人还需要负责系统的性能调优,负责对新员工和初级的员工的培训。定期组织代码的评审,检查代码的抽象与封装程度,以及命名等等问题。。
不重视代码质量的公司,注定不能长久。