代碼質量與文檔質量

幾段在腦子里盤旋了很久的話： 

*
　　帶一個項目，要保證項目的質量，當然要靠Team Leader的水平。那么，什么才是最重要的項目質量呢*當然是代碼質量！一個軟件項目，最重要的產品當然是代碼！
*
　　如果這個Leader看不懂項目的代碼，他只能通過要求文檔的質量，來間接的控制代碼的質量。一個能夠看得懂代碼的Leader，他就能夠直接控制代碼質量。而能夠直接控制代碼質量的Leader，對于文檔的要求，會合理很多。
*
　　直接控制與間接控制，哪一個更加有效，是不言而喻的。當然，那些沒有代碼閱讀能力的Leader，他們會更加強調文檔的重要性，甚至舍本逐末，認為文檔質量才是項目質量的體現。進而變態地追求文檔完美，以至于浪費了程序員寫代碼的時間。這樣的Leader，根本就不可能管好項目的。
*
　　公司往往會出于恐慌，向員工要求很多詳盡的文檔，主要是為了防止員工離職帶來的損失。而問題在于，公司的主要努力，應該用于留住員工，而不是用于加強“善后能力”。更不是為了增強善后能力，搞得員工越發想離開這家公司。
*
btw:
*
補記一段交鋒對話：
《軟件開發項目中的成本比例》是我以前寫的一篇blog，有一個GHawk有這么一段留言：
*
UP和Agile都是工程過程實踐的總結，林德彰先生說過“UP是正楷，XP是草書。先學好了UP，才能學好XP；先學XP再學UP就會亂套?！?nbsp;
Agile強調的是“代碼是真正有價值的東西?！边@同樣也是實踐的結果。二位對于過程有不同的看法并不能說明孰是孰非，這只是在不同的實踐內容和階段上的總結。在過程的選用問題上，只有不斷地實踐才是前進的方向。* 
*
另外還有一篇blog，專門討論這句話。

原文轉自：http://www.kjueaiud.com