為什麼程式設計師不願寫文件

2021-06-02 10:32:27 字數 2357 閱讀 4118

一提到文件,肯定會有人向你大談外國公司、大公司、正規公司是怎麼怎麼重視文件的,什麼2/3時間用於寫文件,1/3時間才用來程式設計序;寫文件要按照什麼iso、什麼cmm、什麼標準;不按這些標準寫出來的就不是文件,就不是好文件;不重視文件就是不正規等。當問及他自己寫過什麼文件,編寫過什麼文件標準的時候,這種人就啞口無言了。

不管怎麼說,文件絕對是程式設計師最大的軟肋。一些稱為高手的程式設計師往往可能是文件方面的低能兒。不管這個程式設計師是在大公司、小公司,不管程式設計師是寫文件的、還是不寫文件的,大部分程式設計師在內心深處都是不願意寫文件的。

程式設計師一般不願意寫文件,但是程式設計師卻喜歡看別人的文件。即使寫文件,程式設計師一般不會把所有功能都寫入文件,卻抱怨別人的文件中有的功能沒有說明。即使願意寫某段文件,程式設計師一般不會把文件寫得很詳細,卻抱怨別人寫的文件不夠詳細。文件絕對是擺在程式設計師面前的乙個矛盾,如果讓程式設計師選擇是喜歡寫文件,還是喜歡看文件,我估計大多數程式設計師都會選擇後者。

那麼程式設計師為什麼不願意寫文件呢?其中的原因很多,我自己歸納了幾點:

1.怕煩

程式設計師從入門之日起,就在心裡埋藏了一顆程式設計的種子,認為程式設計師就是程式設計序的,就是和計算機打交道的,程式就是程式設計師的全部。無論是在程式設計之前寫文件,還是在程式設計之後寫文件。他們都認為寫文件很煩人。

1)文件種類太多。越正規越多。一想到要寫那麼多的文件,程式設計師的頭都要大了。

2)文件寫作要求不低。有格式要求、內容要求,還需要畫各種流程圖、示意圖、關係圖、介面圖和填寫各種**說明,以及要收集各種資料。雖然沒有技術含量,但是要花的時間比程式設計序多,而且也不一定能寫好。

3)在正規的開發公司中一般乙個變更就要編寫一系列的變更文件。當不斷變更時,只有最後的變更文件是最重要的。當我們不知道當前是不是最後乙個文件時,我們就不願意寫可能被後面的文件替代的文件。

4)當寫了文件之後,就會不斷有使用文件的人來詢問細節,這些詢問往往會讓人崩潰。這是因為很難寫出讓每個人都提不出問題的文件。

2.沒空

在很多情況下,程式設計師都處於一種「時間緊、任務重」狀態。在急於得出程式設計結果的驅使下,程式設計師一心撲在程式設計上,恨不得一分鐘乙個變化,哪有心思和時間先把文件寫好再去程式設計呢?即使他們擁有先把程式編出來,然後再補寫文件的想法,但是一旦他們完成一段程式之後,就會立即撲向第二段程式。如此下來,編寫文件只能放在專案開發的後期了。你要是真的寫文件,那寫文件的時間早已將程式設計時間給擠占了,你的程式設計工作就完不成了。

3.沒有用

文件的重要性其實對不同物件是不一樣的。如果你說文件沒有用,立即會有人用唾沫把你淹死,他們立即會搬出哪個哪個說文件是重要的,文件是不可缺的。唯獨不敢說「我自己認為文件是重要的」。這也反過來說明文件的有用性程度對不同人是不一樣的。對於程式設計師來說,只要能把程式編出來就行了。很多程式設計師不寫文件照樣編出程式來,在他們的觀念中文件不寫也罷。如果按文件程式設計序,那就要確保文件的正確性、不可更改性。而實際上,文件不如程式設計快,程式設計不如變化快,不斷變化的需求和**讓文件如同一張過時的廢紙一樣。

在現實中,有的文件變成了專案開發後的總結,對開發本身並不起作用,只是保留乙個存在的形式,以應付各種各樣規範的需要。在這種情況下,文件沒有任何實用價值,所以即使程式設計師寫了,也沒有什麼作用。尤其是專案投產後,幾經公升級,最初的文件早已和現實的情況對不上號了,文件更新和系統的一致性更是難於控制。

4.沒好處

既然認為程式設計序是正道,那麼程式設計師寫文件就是一種額外和輔助的工作,做了就做了,對於程式設計師來說沒有任何好處。

當然,文件的好處更多地體現在軟體公司、單位、軟體使用者、後續程式設計師身上,它是一種「前人栽樹,後人乘涼」的好事。所以程式設計師不願意寫文件。

文件有多麼重要呢?有人把它上公升到「程式設計師頭腦的拷貝」的高度,有的人甚至說,程式設計師走了後,只要有了文件,軟體公司可以再招新人,公司照樣運轉起來。如此說來,天性聰明的程式設計師會把文件寫得清清楚楚嗎?

5.不會寫

當乙個男子向乙個自己喜歡的女子示愛,需要用情書來表白的時候,難道他不會寫情書嗎?即使他不會寫,他也一定會克服千難萬險把情書寫出來的,這是他的主觀使然。如果程式設計師主觀上想寫文件,怎麼會怕煩?怎麼會怕沒空?怎麼會怕文件沒有用?怎麼會怕不會寫?這些怕其實都是藉口。真正優秀的程式設計師應該不單是程式設計的高手,同時也應該是寫文件的高手。

程式設計師真正不喜歡寫文件的原因是:文件是給別人看的,不是給自己看的。如果要使程式設計師喜歡寫文件,那就要提高程式設計師的意識和境界,或者要給寫文件的程式設計師以獎勵。而靠制度、管理讓程式設計師去寫文件只能是一種職業上的弊端。當有一天寫文件也成為乙個專業化的崗位,程式設計師和文件人員分開時,程式設計師就會一心一意看文件寫**,文件員就會以此為職業,一心一意寫文件拿工資。我們將不再為此進行討論。這種分工一定是未來的趨勢。一些大的公司或管理規範的公司都已經有這樣的分工了。只是很多中小軟體公司或企事業單位裡的it部門還沒有專業化到如此程度。程式設計師不喜歡寫文件也許說明他們不願意承擔太多的角色吧。

為什麼程式設計師不願寫文件

一提到文件,肯定會有人向你大談外國公司 大公司 正規公司是怎麼怎麼重視文件的,什麼2 3時間用於寫文件,1 3時間才用來程式設計序 寫文件要按照什麼iso 什麼cmm 什麼什麼標準 不按這些標準寫出來的就不是文件,就不是好文件。不重視文件就是不正規等等等。當問及他自己寫過什麼文件,編寫過什麼文件標準...

為什麼程式設計師不願寫文件

一提到文件,肯定會有人向你大談外國公司 大公司 正規公司是怎麼怎麼重視文件的,什麼 2 3時間用於寫文件,1 3時間才用來程式設計序 寫文件要按照什麼 iso 什麼 cmm 什麼什麼標準 不按這些標準寫出來的就不是文件,就不是好文件。不重視文件就是不正規等等等。當問及他自己寫過什麼文件,編寫過什麼文...

為什麼程式設計師不願意寫文件

一提到文件,肯定會有人向你大談外國公司 大公司 正規公司是怎麼怎麼重視文件的,什麼2 3時間用於寫文件,1 3時間才用來程式設計序 寫文件要按照什麼iso 什麼cmm 什麼標準 不按這些標準寫出來的就不是文件,就不是好文件 不重視文件就是不正規等。當問及他自己寫過什麼文件,編寫過什麼文件標準的時候,...