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

2021-05-23 00:01:59 字數 3001 閱讀 7021

一提到文件,肯定會有人向你大談外國公司、大公司、正規公司是怎麼怎麼重視文件的,什麼

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 什麼標準 不按這些標準寫出來的就不是文件,就不是好文件 不重視文件就是不正規等。當問及他自己寫過什麼文件,編寫過什麼文件標準的時候,...