導航:首頁 > 程序命令 > 程序員不願寫文檔

程序員不願寫文檔

發布時間:2022-09-18 15:15:12

① 開發人員為什麼不願意寫文檔

有以下幾點。
1.怕煩
程序員從入門之日起,就在心裡埋藏了一顆編程的種子,認為程序員就是編程序的,就是和計算機打交道的,程序就是程序員的全部。無論是在編程之前寫文檔,還是在編程之後寫文檔。他們都認為寫文檔很煩人。
1)文檔種類太多。越正規越多。一想到要寫那麼多的文檔,程序員的頭都要大了。
2)文檔寫作要求不低。有格式要求、內容要求,還需要畫各種流程圖、示意圖、關系圖、界面圖和填寫各種表格說明,以及要收集各種資料。雖然沒有技術含量,但是要花的時間比編程序多,而且也不一定能寫好。
3)在正規的開發公司中一般一個變更就要編寫一系列的變更文檔。當不斷變更時,只有最後的變更文檔是最重要的。當我們不知道當前是不是最後一個文檔時,我們就不願意寫可能被後面的文檔替代的文檔。
4)當寫了文檔之後,就會不斷有使用文檔的人來詢問細節,這些詢問往往會讓人崩潰。這是因為很難寫出讓每個人都提不出問題的文檔。
2.沒空
在很多情況下,程序員都處於一種「時間緊、任務重」狀態。在急於得出編程結果的驅使下,程序員一心撲在編程上,恨不得一分鍾一個變化,哪有心思和時間先把文檔寫好再去編程呢?即使他們擁有先把程序編出來,然後再補寫文檔的想法,但是一旦他們完成一段程序之後,就會立即撲向第二段程序。如此下來,編寫文檔只能放在項目開發的後期了。你要是真的寫文檔,那寫文檔的時間早已將編程時間給擠佔了,你的編程工作就完不成了。

② 程序員為什麼討厭寫文檔

因為沒有代碼提示功能.

③ 開發人員為什麼不願意寫文檔

有以下幾點。
1.怕煩
程序員從入門之日起,就在心裡埋藏了一顆編程的種子,認為程序員就是編程序的,就是和計算機打交道的,程序就是程序員的全部。無論是在編程之前寫文檔,還是在編程之後寫文檔。他們都認為寫文檔很煩人。
1)文檔種類太多。越正規越多。一想到要寫那麼多的文檔,程序員的頭都要大了。
2)文檔寫作要求不低。有格式要求、內容要求,還需要畫各種流程圖、示意圖、關系圖、界面圖和填寫各種表格說明,以及要收集各種資料。雖然沒有技術含量,但是要花的時間比編程序多,而且也不一定能寫好。
3)在正規的開發公司中一般一個變更就要編寫一系列的變更文檔。當不斷變更時,只有最後的變更文檔是最重要的。當我們不知道當前是不是最後一個文檔時,我們就不願意寫可能被後面的文檔替代的文檔。
4)當寫了文檔之後,就會不斷有使用文檔的人來詢問細節,這些詢問往往會讓人崩潰。這是因為很難寫出讓每個人都提不出問題的文檔。

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

④ 我想入門

軟體質量是被大多數程序員掛在嘴上而不是放在心上的東西!
除了完全外行和真正的編程高手外,初讀本書,你最先的感受將是驚慌:「哇!我以前捏造的C++/C程序怎麼會有那麼多的毛病?」
別難過,作者只不過比你早幾年、多幾次驚慌而已。
請花一兩個小時認真閱讀這本百頁經書,你將會獲益匪淺,這是前面N-1個讀者的建議。

一、編程老手與高手的誤區

自從計算機問世以來,程序設計就成了令人羨慕的職業,程序員在受人寵愛之後容易發展成為毛病特多卻常能自我臭美的群體。
如今在Internet上流傳的「真正」的程序員據說是這樣的:
(1) 真正的程序員沒有進度表,只有討好領導的馬屁精才有進度表,真正的程序員會讓領導提心吊膽。
(2) 真正的程序員不寫使用說明書,用戶應當自己去猜想程序的功能。
(3) 真正的程序員幾乎不寫代碼的注釋,如果注釋很難寫,它理所當然也很難讀。
(4) 真正的程序員不畫流程圖,原始人和文盲才會干這事。
(5) 真正的程序員不看參考手冊,新手和膽小鬼才會看。
(6) 真正的程序員不寫文檔也不需要文檔,只有看不懂程序的笨蛋才用文檔。
(7) 真正的程序員認為自己比用戶更明白用戶需要什麼。
(8) 真正的程序員不接受團隊開發的理念,除非他自己是頭頭。
(9) 真正的程序員的程序不會在第一次就正確運行,但是他們願意守著機器進行若干個30小時的調試改錯。
(10) 真正的程序員不會在上午9:00到下午5:00之間工作,如果你看到他在上午9:00工作,這表明他從昨晚一直干到現在。
……
具備上述特徵越多,越顯得水平高,資格老。所以別奇怪,程序員的很多缺點竟然可以被當作優點來欣賞。就象在武俠小說中,那些獨來獨往、不受約束且帶點邪氣的高手最令人崇拜。我曾經也這樣信奉,並且希望自己成為那樣的「真正」的程序員,結果沒有得到好下場。

我從讀大學到博士畢業十年來一直勤奮好學,累計編寫了數十萬行C++/C代碼。有這樣的苦勞和疲勞,我應該稱得上是編程老手了吧?
我開發的軟體都與科研相關(集成電路CAD和3D圖形學領域),動輒數萬行程序,技術復雜,難度頗高。這些軟體頻頻獲獎,有一個軟體獲得首屆中國大學生電腦大賽軟體展示一等獎。在1995年開發的一套圖形軟體庫到2000年還有人買。羅列出這些「業績」,可以說明我算得上是編程高手了吧?
可惜這種個人感覺不等於事實。

讀博期間我曾用一年時間開發了一個近10萬行C++代碼的3D圖形軟體產品,我內心得意表面謙虛地向一位真正的軟體高手請教。他雖然從未涉足過3D圖形領域,卻在幾十分鍾內指出該軟體多處重大設計錯誤。讓人感覺那套軟體是用紙糊的華麗衣服,扯一下掉一塊,戳一下破個洞。我目瞪口呆地意識到這套軟體毫無實用價值,一年的心血白化了,並且害死了自己的軟體公司。

人的頓悟通常發生在最心痛的時刻,在沮喪和心痛之後,我作了深刻反省,「面壁」半年,重新溫習軟體設計的基礎知識。補修「內功」之後,又覺得腰板硬了起來。博士畢業前半年,我曾到微軟中國研究院找工作,接受微軟公司一位資深軟體工程師的面試。他讓我寫函數strcpy的代碼。
太容易了吧?
錯!
這么一個小不點的函數,他從三個方面考查:
(1)編程風格;
(2)出錯處理;
(3)演算法復雜度分析(用於提高性能)。
在大學里從來沒有人如此嚴格地考查過我的程序。我化了半個小時,修改了數次,他還不盡滿意,讓我回家好好琢磨。我精神抖擻地進「考場」,大汗淋漓地出「考場」。這「高手」當得也太窩囊了。我又好好地反省了一次。

我把反省後的心得體會寫成文章放在網上傳閱,引起了不少軟體開發人員的共鳴。我因此有幸和國產大型IT企業如華為、上海貝爾、中興等公司的同志們廣泛交流。大家認為提高質量與生產率是軟體工程要解決的核心問題。高質量程序設計是非常重要的環節,畢竟軟體是靠編程來實現的。
我們心目中的老手們和高手們能否編寫出高質量的程序來?
不見得都能!

就我的經歷與閱歷來看,國內大學的計算機教育壓根就沒有灌輸高質量程序設計的觀念,教師們和學生們也很少自覺關心軟體的質量。勤奮好學的程序員長期在低質量的程序堆中滾爬,吃盡苦頭之後才有一些心得體會,長進極慢,我就是一例。
現在國內IT企業擁有學士、碩士、博士文憑的軟體開發人員比比皆是,但他們在接受大學教育時就「先天不足」,豈能一到企業就突然實現質的飛躍。試問有多少軟體開發人員對正確性、健壯性、可靠性、效率、易用性、可讀性(可理解性)、可擴展性、可復用性、兼容性、可移植性等質量屬性了如指掌?並且能在實踐中運用自如?。「高質量」可不是幹活小心點就能實現的!

我們有充分的理由疑慮:
(1)編程老手可能會長期用隱含錯誤的方式編程(習慣成自然),發現毛病後都不願相信那是真的!
(2)編程高手可以在某一領域寫出極有水平的代碼,但未必能從全局把握軟體質量的方方面面。

事實證明如此。我到上海貝爾工作一年來,陸續面試或測試過近百名「新」「老」程序員的編程技能,質量合格率大約是10%。很少有人能夠寫出完全符合質量要求的if語句,很多程序員對指針、內存管理一知半解,……。
領導們不敢相信這是真的。我做過現場試驗:有一次部門新進14名碩士生,在開歡迎會之前對他們進行「C++/C編程技能」摸底考試。我問大家試題難不難?所有的人都回答不難。結果沒有一個人及格,有半數人得零分。競爭對手公司的朋友們也做過試驗,同樣一敗塗地。

真的不是我「心狠手辣」或者要求過高,而是很多軟體開發人員對自己的要求不夠高。
要知道華為、上海貝爾、中興等公司的員工素質在國內IT企業中是比較前列的,倘若他們的編程質量都如此差的話,我們怎麼敢期望中小公司拿出高質量的軟體呢?連程序都編不好,還談什麼振興民族軟體產業,豈不胡扯。

我打算定義編程老手和編程高手,請您別見笑。
定義1:能長期穩定地編寫出高質量程序的程序員稱為編程老手。
定義2:能長期穩定地編寫出高難度、高質量程序的程序員稱為編程高手。
根據上述定義,馬上得到第一推論:我既不是高手也算不上是老手。

在寫此書前,我閱讀了不少程序設計方面的英文著作,越看越羞慚。因為發現自己連編程基本技能都未能全面掌握,頂多算是二流水平,還好意思談什麼老手和高手。希望和我一樣在國內土生土長的程序員朋友們能夠做到:
(1)知錯就改;
(2)經常溫故而知新;
(3)堅持學習,天天向上。

⑤ 哎!做程序員一年了,感覺有的時候看不懂開發文檔,感覺很枯燥老想著看視頻入門我這種的是不是可以轉行了

現在的你不是考慮轉不轉行的時候 既然你已經堅持了一年 那最起碼基本的能力還是有的 你夜深人靜的時候好好想想吧 任何行業 起步都難 難道你轉行,頭一年能樂得輕松自在嘛?編程工作第一年甚至第二年都是很西辛苦很痛苦的,哥們跟你說實話我也做了一年程序員 今年幹了別的行業 才發現根本沒我當初想的那麼好 也是從頭開始 和程序員頭一年沒差別 所以我明年決定回到開發工作 再干幾年 賺點資金再考慮搞別的

⑥ 軟體開發 不重視文檔,會出現什麼問題

沒有開發文檔指導,程序員們寫的代碼就會不符合要求啊、不方便二次開發啊、層次混亂啊,對接不通啊等等問題。出在交付前的問題解決了,可是沒有開發文檔,以後的工作會很困難。
但我感覺啊,小項目前期就不要花費太多精力和事件搞開發文檔了,等做完後再補起來就行。
搞敏捷開發的認為寫開發文檔是很浪費時間和出力不討好的事情,特別是面對需求變更的情況。
但是么,按照公司要求來吧,經理叫寫就寫唄。不是特別嚴,每天開會,每天上報工作進展的話,完成一部分再補齊文檔也行哈。
以上純屬個人理解,如與實際情況不符,請參照高人指點。

⑦ Java程序員,你們在項目里寫文檔么

恩,要寫,
這是你做項目前的預備工作啊~
你瞧我們在每學期最後做項目都要交的文檔就有20來個包括軟體系統分析,測試用例,系統設計報告等等一些。
一個文檔就得發上那麼2周的時間。
說老實話,如果一個項目沒有做項目文檔,那麼那個軟體將來出來一定會有很多的BAG。

⑧ 程序員到底需不需要寫文檔

您好:
需要寫,而且需要好好寫。
不論是前期的設計文檔,開發文檔。

還是後期的測試文檔,實施文檔,用戶手冊,FAQ。
這些文檔是伴隨著整個工作來的。。。
降低溝通成本,提高溝通效率。。。

⑨ 程序員為什麼都不喜歡做文檔工作

主要的原因是因為程序員不會寫文檔,寫出來的文檔不符合規范。

寫文檔在軟體工程當中是非常重要的,CNN非常強調文檔的編寫,在CNN開發代碼是貫穿整個開發過程,記錄各種情況,以便追蹤,這是復雜的工作,有著詳細的編寫規范,是軟體成敗的關鍵,占整個開發工作量的30—40%,而代碼編寫只佔20%-30%。國外成熟的軟體企業大規模生產軟體是採用這種方式,中國的軟體開發很多還不成熟,只是幾個人憑興趣、愛好獨個編寫,弄得一塌糊塗。

中國絕大部分程序員都不會寫文檔!

⑩ 我是個編程的自學者,想當程序員不知道公司寫文檔是什麼意思知道的情給我解釋一下,還有具體是怎樣工作的

以鄙人在軟體公司工作的經驗與你分享一下吧。
我們平時做項目,一般有一半以上時間都在管理文檔,包括基本設計書,詳細設計書,靜態樣式書,各種UML建模圖,單體測試書,系統測試數,結合測試書,DB設計書,DB腳本,以及各種工具類管理文檔,如資源文件管理,VBA管理等等,這還不包括項目前期的需求建設書,項目中期與客戶交流的反饋書,項目後期的BUG管理書,以及貫穿項目的工程進度表和版本控制書。當然你的代碼資源(包括注釋,圖片,腳本等)也屬於文檔,需要統一管理。
對於追求簡短快的團隊,未必會太重視文檔的組織與管理,但是一定要相信文檔看似浪費時間,其實無形中提高了很大的效率,而且在未來的開發提供了寶貴的參考資料。屬於團隊積累的一種。

閱讀全文

與程序員不願寫文檔相關的資料

熱點內容
php跑在什麼伺服器 瀏覽:112
編譯器怎麼跳轉到下一行 瀏覽:446
嵌入式py編譯器 瀏覽:323
rplayer下載安卓哪個文件夾 瀏覽:298
安卓手機里的電子狗怎麼用 瀏覽:748
pythonspyder入門 瀏覽:764
趣質貓app是什麼 瀏覽:60
皮帶壓縮機經常吸不上 瀏覽:205
西部隨行版怎樣加密 瀏覽:996
釘釘上如何壓縮圖片 瀏覽:924
cad輸入命令不顯示窗口 瀏覽:618
小米視頻加密之後怎麼看 瀏覽:76
超級程序員劉芳閱讀 瀏覽:833
顧家九爺在哪個app 瀏覽:820
我的世界怎麼在聯機大廳做伺服器 瀏覽:290
分手程序員 瀏覽:448
php將html導出為word 瀏覽:802
騰訊加密視頻能破解嗎 瀏覽:1008
反編譯後導入eclipse 瀏覽:949
買阿里雲伺服器有郵箱嗎 瀏覽:825