代码质量与文档质量

发表于:2008-11-05来源:作者:点击数: 标签:代码质量文档
关键字:代码 质量 文档质量 几段在脑子里盘旋了很久的话: * 带一个项目,要保证项目的质量,当然要靠TeamLeader的水平。那么,什么才是最重要的项目质量呢*当然是代码质量!一个软件项目,最重要的产品当然是代码! * 如果这个Leader看不懂项目的代码,他
关键字:代码质量 文档质量
几段在脑子里盘旋了很久的话: 

*
  带一个项目,要保证项目的质量,当然要靠Team Leader的水平。那么,什么才是最重要的项目质量呢*当然是代码质量!一个软件项目,最重要的产品当然是代码!
*
  如果这个Leader看不懂项目的代码,他只能通过要求文档的质量,来间接的控制代码的质量。一个能够看得懂代码的Leader,他就能够直接控制代码质量。而能够直接控制代码质量的Leader,对于文档的要求,会合理很多。
*
  直接控制与间接控制,哪一个更加有效,是不言而喻的。当然,那些没有代码阅读能力的Leader,他们会更加强调文档的重要性,甚至舍本逐末,认为文档质量才是项目质量的体现。进而变态地追求文档完美,以至于浪费了程序员写代码的时间。这样的Leader,根本就不可能管好项目的。
*
  公司往往会出于恐慌,向员工要求很多详尽的文档,主要是为了防止员工离职带来的损失。而问题在于,公司的主要努力,应该用于留住员工,而不是用于加强“善后能力”。更不是为了增强善后能力,搞得员工越发想离开这家公司。
*
btw:
*
补记一段交锋对话:
《软件开发项目中的成本比例》是我以前写的一篇blog,有一个GHawk有这么一段留言:
*
UP和Agile都是工程过程实践的总结,林德彰先生说过“UP是正楷,XP是草书。先学好了UP,才能学好XP;先学XP再学UP就会乱套。” 
Agile强调的是“代码是真正有价值的东西。”这同样也是实践的结果。二位对于过程有不同的看法并不能说明孰是孰非,这只是在不同的实践内容和阶段上的总结。在过程的选用问题上,只有不断地实践才是前进的方向。* 
*
另外还有一篇blog,专门讨论这句话。

原文转自:http://www.ltesting.net