posts - 59,  comments - 323,  trackbacks - 0
  几段在脑子里盘旋了很久的话:
 
  带一个项目,要保证项目的质量,当然要靠Team Leader的水平。那么,什么才是最重要的项目质量呢?当然是代码质量!一个软件项目,最重要的产品当然是代码!
 
  如果这个Leader看不懂项目的代码,他只能通过要求文档的质量,来间接的控制代码的质量。一个能够看得懂代码的Leader,他就能够直接控制代码质量。而能够直接控制代码质量的Leader,对于文档的要求,会合理很多。
 
  直接控制与间接控制,哪一个更加有效,是不言而喻的。当然,那些没有代码阅读能力的Leader,他们会更加强调文档的重要性,甚至舍本逐末,认为文档质量才是项目质量的体现。进而变态地追求文档完美,以至于浪费了程序员写代码的时间。这样的Leader,根本就不可能管好项目的。
 
  公司往往会出于恐慌,向员工要求很多详尽的文档,主要是为了防止员工离职带来的损失。而问题在于,公司的主要努力,应该用于留住员工,而不是用于加强“善后能力”。更不是为了增强善后能力,搞得员工越发想离开这家公司。
 
btw:
 
补记一段交锋对话:
软件开发项目中的成本比例》是我以前写的一篇blog,有一个GHawk有这么一段留言:
 
UP和Agile都是工程过程实践的总结,林德彰先生说过“UP是正楷,XP是草书。先学好了UP,才能学好XP;先学XP再学UP就会乱套。”
Agile强调的是“代码是真正有价值的东西。”这同样也是实践的结果。二位对于过程有不同的看法并不能说明孰是孰非,这只是在不同的实践内容和阶段上的总结。在过程的选用问题上,只有不断地实践才是前进的方向。 
 
另外还有一篇blog,专门讨论这句话。
 
我的回答是:
 
林德彰的说法,是一个在校教师,典型的和稀泥的说法,我不同意。
 
没想到今天有一个朋友WANG回了一帖:
 
老林是在校教师?你应该去看一下人家在美国打拼的经验~~  
 
我的回复是:
他在美国打拼怎么了?还有好多土生土长的美国人,也不鸟那什么UP呢?
我为什么要听一个海龟来上课呢?
这年头,海龟还不够多吗?

另外对GHawk多说一句话:让组员快速磨合的最好办法,是结对编程,而不是大家埋头写文档。
posted on 2006-04-22 21:35 读书、思考、生活 阅读(29901) 评论(21)  编辑  收藏


FeedBack:
# re: 代码质量与文档质量
2006-04-22 23:27 | charon@xxx
问个问题,一个观点的对错,和表达这个观点的人有关系么?
在校教师没什么问题,即便人家是反动派,也不说明他说的话就一定是错的。
没必要从一个的人品/资历如何出发来否定他的观点。否则,大家都按照资历排排座好了。或者按照官位大小,官最大的最正确
  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-23 13:00 | Harryson
我觉得代码和文档都很重要.
当然对于公司来说,最好的方法还是怎样的留住人才.  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-23 13:20 | mixlee
对于软件公司来说,
自己的开发框架才是最重要的。
有了一个好的开发框架,代码质量就可控制,一切才能走上正轨。
就如同工厂如果没有一套生产线,那么做出来的产品必定是不稳定的。
现在的公司,有几家拥有自己的开发框架?有几个项目经理手里掌握着成熟的开发框架?全部由零做起,不乱套才怪。  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-23 19:59 | jelly--
/*
那些没有代码阅读能力的Leader,他们会更加强调文档的重要性,甚至舍本逐末,认为文档质量才是项目质量的体现。进而变态地追求文档完美,以至于浪费了程序员写代码的时间。这样的Leader,根本就不可能管好项目的。
*/

没有阅读代码能力的leader就一定管理不好项目? 这种想法太片面了

  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-23 20:42 | 读书、思考、生活
to:charon@xxx

不是因为他是在校教师,所以我看不起他。而是因为他的话,我认为不正确,所以一开始将其归结为在校教师的“和稀泥”。以我的经验,大多数学校教师,教别人软件开发的老师,对于当前软件开发中的很多实践,并无深入的认识。

UP是正楷、XP是草书,这种话,毫无意义。因为UP是一种过程管理模式,而XP其实质是一种开发思想。岂可同日而语?

后来WANG又提出所谓的海龟背景,岂不是更加无稽?

to:mixlee
如果一家公司,要做一个以前没有做过的项目,要涉及以没有进入过的领域呢?

to:jelly--
注意看我的话

没有代码阅读能力的Leader,不一定管不好项目,而如果他“舍本逐末,认为文档质量才是项目质量的体现。进而变态地追求文档完美,以至于浪费了程序员写代码的时间。”这样才会管不好项目。  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-23 21:29 | 寒晴天
假如再加一倍的人手,请问,项目的文档是否会完整呢?  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-24 12:36 | jelly-ll
TO: 读书、思考、生活

我不想去咬文嚼字, 我想问一下, 你们开发是先出文档, 还是先写代码, 在写文档?  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-24 20:38 | 读书、思考、生活
to:jelly-ll

http://forum.javaeye.com/viewtopic.php?t=20063

正好可以推荐你看看这篇帖子  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-25 23:27 | mixlee
这个跟以前有没做过没啥关系。
做没做过应该是指业务逻辑。与开发框架无关。
如果具备开发框架的思想,那么即使是进入一个新的技术领域,也会先把开发相应的框架做起来然后再做业务应用。  回复  更多评论
  
# re: 代码质量与文档质量
2006-04-26 00:32 | 读书、思考、生活
to:mixlee
我们俩说的是不相干的两件事  回复  更多评论
  
# re: 代码质量与文档质量
2006-05-11 16:18 | 逸云
偶尔路过,对你的观点很不赞同。不过喜欢你这较真的劲!
为文档而文档是愚蠢的行为,为代码而代码比上者更甚。
不同规模的公司、不同规模的项目在代码质量和文档质量之间需要找到一些平衡。
理解为什么文档需要你过几年才能懂,你现在还在忙于coding的层次,等你开始分析,做项目经理、部门经理甚至自己做公司以后,你会慢慢懂得文档的价值。。。

如有异议,请邮件或MSN: xtding@hotmail.com  回复  更多评论
  
# re: 代码质量与文档质量
2006-06-21 12:46 | mm
不错  回复  更多评论
  
# re: 代码质量与文档质量
2007-10-19 11:05 | ilex
本来是想找篇程序说明文档,请问你有程序说明文档的例子么,借鉴一下:)  回复  更多评论
  
# re: 代码质量与文档质量
# re: 代码质量与文档质量
# re: 代码质量与文档质量
2009-08-21 11:53 | programmer
1.是先有文档然后才有代码,文档是根,代码是儿子;如果现有代码然后再有文档,那就不是CMMI
2.文档指导代码,以确定代码的方向是正确的
3.写完代码,然后再修订文档,只是让文档更加完美。
4. 不同意楼主的先代码后文档,或是重代码轻文档的方法  回复  更多评论
  

只有注册用户登录后才能发表评论。


网站导航:
 
<2006年4月>
2627282930311
2345678
9101112131415
16171819202122
23242526272829
30123456

常用链接

留言簿(20)

随笔档案

友情BLOG

搜索

  •  

最新评论

阅读排行榜

评论排行榜