Post By：2018/1/15 9:16:14 軟件開(kāi)發(fā)人員不愿意寫(xiě)文檔，我想這主要指的是剛參加工作時(shí)間不長(zhǎng)的工作人員。真正的老鳥(niǎo)是不會(huì)這樣的。我說(shuō)說(shuō)自己的看法，希望大家討論。
1.軟件開(kāi)發(fā)的大環(huán)境不好
軟件開(kāi)發(fā)行業(yè)在中國(guó)的興起也就是十幾年的事情，國(guó)外的軟件開(kāi)發(fā)比中國(guó)長(zhǎng)，但也有限，與中國(guó)不同是，國(guó)外企業(yè)很重視質(zhì)量管理，過(guò)程控制。國(guó)外的軟件發(fā)展受其他行業(yè)的影響比較深，基本上是兩個(gè)思路，一個(gè)是美國(guó)為主，他們不斷針對(duì)開(kāi)發(fā)中的問(wèn)題形成新的開(kāi)發(fā)方法，比如psp，tsp，rup，iso， cmm/cmmi等過(guò)程對(duì)規(guī)范軟件開(kāi)發(fā)流程起了很大的作用，而日本和印度基本走的是另外一條路。比如日本開(kāi)發(fā)基本是瀑布型，但每一個(gè)步驟都極為細(xì)致，以此達(dá)到對(duì)軟件質(zhì)量的控制，印度基本是cmm，其思路和日本查不多，但不論是美國(guó)，日本，還是印度在這些過(guò)程控制過(guò)程中都強(qiáng)調(diào)，計(jì)劃-執(zhí)行-檢查-調(diào)整，而這些都需要文檔的支持，所以相對(duì)來(lái)說(shuō)，他們的大環(huán)境比中國(guó)好的多。反觀中國(guó)，從文化上來(lái)說(shuō)，中國(guó)的文化階層歷來(lái)喜歡務(wù)虛而不務(wù)實(shí)，大家在討論的時(shí)候都侃侃而談，但一旦想落實(shí)紙面上就沒(méi)有人愿意干了。這也表現(xiàn)在到現(xiàn)在為止，還沒(méi)有聽(tīng)說(shuō)中國(guó)出過(guò)軟件開(kāi)發(fā)大師級(jí)人物。而軟件行業(yè)前一段時(shí)間還被稱為高科技，這一方面也造成了開(kāi)發(fā)人員浮躁的心態(tài)。
2.重技巧的學(xué)習(xí)，而輕視能力的培養(yǎng)
中國(guó)的軟件開(kāi)發(fā)人員重視對(duì)技巧的學(xué)習(xí)，比如我們的一個(gè)項(xiàng)目負(fù)責(zé)人，對(duì)ie的cookie很熟悉，也很愿意在他的組員面前顯示他的才能，可是他連基本的編程規(guī)范都不了解，而對(duì)調(diào)研的方式方法項(xiàng)目管理的范圍定義，時(shí)間管理，風(fēng)險(xiǎn)管理，質(zhì)量管理更是一竅不通，這樣的項(xiàng)目經(jīng)理怎么可能寫(xiě)出好的文檔，而他的團(tuán)隊(duì)又怎么可能寫(xiě)出完善的文檔。
3.重視表面的東西，輕視基礎(chǔ)
建設(shè)在沙地上的萬(wàn)丈高樓怎么可能不危險(xiǎn)，舉一個(gè)例子，在過(guò)去做面向過(guò)程的系統(tǒng)開(kāi)發(fā)的時(shí)候，有幾個(gè)人會(huì)畫(huà)標(biāo)準(zhǔn)的數(shù)據(jù)流圖，在作數(shù)據(jù)庫(kù)設(shè)計(jì)的人員中，有幾個(gè)人講的清楚1NF，2NF，3NF，BCNF，在面向?qū)ο蟮脑O(shè)計(jì)中有幾個(gè)人可以畫(huà)出標(biāo)準(zhǔn)的9種類型的設(shè)計(jì)圖。這些東西我們?cè)趯W(xué)校里都學(xué)習(xí)過(guò)，請(qǐng)大家想想我們有幾個(gè)人真正使用過(guò)，而用拍腦門(mén)出來(lái)的設(shè)計(jì)，能不出問(wèn)題嗎？
4.對(duì)系統(tǒng)不了解，是不愿意寫(xiě)文檔的最主要的原因
調(diào)研人員自認(rèn)為對(duì)客戶流程很了解，讓他講解的時(shí)候看起來(lái)也是頭頭是道，但他們?yōu)槭裁床辉敢鈱?xiě)，其實(shí)在就是因?yàn)樗麄儗?duì)客戶的流程并沒(méi)有作到真實(shí)的了解。在討論的時(shí)候，如果沒(méi)有文檔，他講過(guò)的話其他人員很難在短時(shí)間內(nèi)理解并且進(jìn)行檢查（聽(tīng)別人說(shuō)話最好也只能吸收10%的東西），而如果是寫(xiě)成文檔，別人看，很多問(wèn)題就可以發(fā)現(xiàn)（看東西可以吸收20%的東西），而且看的時(shí)間會(huì)比較長(zhǎng)，如果是一個(gè)比較認(rèn)真的人還會(huì)前后對(duì)照，這樣很多問(wèn)題自然會(huì)暴露出來(lái)。所以避免被別人發(fā)現(xiàn)問(wèn)題方法就是不寫(xiě)文檔，這樣即使出問(wèn)題了，也是死無(wú)對(duì)證，而一旦留有文字資料，你就跑不了。
開(kāi)發(fā)人員其實(shí)也差不多，我們的高級(jí)程序員，程序員都崇尚于談?wù)撨@個(gè)體系，那個(gè)體系，但作JAVA的有幾個(gè)可以講明白J2EE，EJB的，又有幾個(gè)閱讀過(guò)tomcat的源代碼。這些都不說(shuō)，你們對(duì)JAVA的類庫(kù)了解多少，知道多少類，他們內(nèi)部變量的類型，作用是什么，他們的成員函數(shù)的功能，輸入輸出是什么，你也許會(huì)說(shuō)，這些東西還要記憶嗎？我們有手冊(cè)可以查。沒(méi)錯(cuò)，但學(xué)習(xí)英語(yǔ)的時(shí)候你能只學(xué)語(yǔ)法，不學(xué)習(xí)單詞嗎？我的原來(lái)一個(gè)頭是做匯編的，他老人家可以隨口說(shuō)出多少號(hào)中斷是做什么用的，AX。BX。CX。DX都應(yīng)該是什么值。不下這個(gè)功夫，你想寫(xiě)出好的詳細(xì)設(shè)計(jì)簡(jiǎn)直是癡人說(shuō)夢(mèng)。而我們現(xiàn)在的開(kāi)發(fā)人員有幾個(gè)可以做到，對(duì)開(kāi)發(fā)環(huán)境不了解，是我們開(kāi)發(fā)人員最大的問(wèn)題，為了掩蓋自己的不足，最好的方法當(dāng)然是不寫(xiě)文檔，避免暴露自己的不足。
5.有經(jīng)驗(yàn)的開(kāi)發(fā)人員的流失造成我們的開(kāi)發(fā)低水平循環(huán)。經(jīng)驗(yàn)無(wú)法繼承
俗話說(shuō)吃一塹長(zhǎng)一智，國(guó)外的軟件流程管理，質(zhì)量管理大家都是年齡很大的人了。但我們的社會(huì)卻很少愿意容納我們自己的有經(jīng)驗(yàn)的開(kāi)發(fā)人員。如果你到各個(gè)招聘網(wǎng)站看一下就會(huì)發(fā)現(xiàn)，現(xiàn)在招技術(shù)人員，都要35以下的，也就是說(shuō)，35以后要不你就在一個(gè)地方呆著，要不你就轉(zhuǎn)行。而在幾年前更夸張，30就一個(gè)坎，30歲是一個(gè)什么概念，舉一個(gè)例子，研究生畢業(yè)一般是25歲，做2-3個(gè)項(xiàng)目（大項(xiàng)目一般是1年以上的），無(wú)論成果還是失敗，你剛有了一些經(jīng)驗(yàn)，好你已經(jīng)快30 了，你面臨是是否還能否在這個(gè)行業(yè)干下去的問(wèn)題，而這個(gè)時(shí)候往往是你開(kāi)始發(fā)現(xiàn)問(wèn)題，開(kāi)始琢磨改進(jìn)方法的時(shí)候（也是你開(kāi)始想開(kāi)始寫(xiě)文檔的時(shí)候），但人生的選擇使你不得不放棄改進(jìn)工作的方法，（真正了解文檔的作用的人都是那些干過(guò)很多項(xiàng)目，有很多失敗教訓(xùn)的“老”開(kāi)發(fā)人員）。于是你要走了，而新人總是高估自己，于是就向飛蛾一樣撲向烈火（糟糕的開(kāi)發(fā)方法，也包括對(duì)文檔的輕視）
6.不會(huì)講問(wèn)題分層次，復(fù)雜問(wèn)題講不清楚，是開(kāi)發(fā)人員不寫(xiě)文檔的另外一個(gè)原因
中國(guó)的開(kāi)發(fā)人員有一個(gè)特點(diǎn)就是都是希望成為好工匠（其實(shí)好工匠都談不上），而不想做專業(yè)人員。如果一個(gè)問(wèn)題原來(lái)處理過(guò)，最起碼看別人處理過(guò)，那么心里就覺(jué)得比較放心，但如果遇到一個(gè)全新的問(wèn)題，有沒(méi)有人咨詢，就不知道如何下手了，說(shuō)簡(jiǎn)單一點(diǎn)就是沒(méi)有學(xué)會(huì)處理問(wèn)題的方法，不會(huì)將復(fù)雜問(wèn)題分層次，不會(huì)將問(wèn)題分解為簡(jiǎn)單問(wèn)題，逐個(gè)處理。所以在寫(xiě)文檔的時(shí)候就不知道該寫(xiě)文檔，一個(gè)問(wèn)題的一個(gè)表現(xiàn)就是大家都熱衷于向朋友們尋求各種系統(tǒng)的文檔，好自己照貓畫(huà)虎，而如果找不到類似的文檔，就不知道怎么辦了。
7.糟糕的寫(xiě)作功底，是不寫(xiě)文檔的一個(gè)原因
我們是學(xué)理工，文字功力差一點(diǎn)沒(méi)有關(guān)系，這是很多軟件人員的說(shuō)法，別開(kāi)玩笑了，很多開(kāi)發(fā)人員不寫(xiě)文檔，一個(gè)原因就是他們的文檔說(shuō)的根本不是中國(guó)話，不要說(shuō)同音同義字的錯(cuò)誤，就連基本的語(yǔ)法都不對(duì)，寫(xiě)得需求不要說(shuō)用戶看不明白，我們自己看都不明白，如果讓他自己朗讀一遍，那恐怕比周星星的電影還要無(wú)理頭，這種文檔開(kāi)發(fā)人員自然不愿意寫(xiě)。
8.最后一個(gè)原因----沒(méi)有吃過(guò)糖，不知道甜是什么滋味
這是一個(gè)很實(shí)在有很尷尬的現(xiàn)實(shí)，很多人沒(méi)有進(jìn)行過(guò)正規(guī)的開(kāi)發(fā)，甚至沒(méi)有見(jiàn)過(guò)真正‘好’的技術(shù)文檔，自然就不能感受好文檔的作用，于是認(rèn)為現(xiàn)在這種糟糕的文檔就是最好的，而這些文檔對(duì)開(kāi)發(fā)沒(méi)有任何作用（反而耽誤時(shí)間），自然就不愿意在寫(xiě)文檔了。
http://www.51testing.com/html/41/n-197641.html
