㈠ java面試官問有沒有寫過文檔(面試java程序員),我想知道寫文檔是指什麼,是設計文檔還是需求文檔還是其他
一般大點的公司需求文檔還是不需要你去編寫的,不過需要開發人員協同討論與審批,
一般開發人員要寫的是 概要設計文檔,和詳細設計文檔之類的
至於步驟要看公司而定,有的是開發完成後才去補寫這樣的文檔,有的是在開發前就需要
將文檔寫好,然後按照文檔來開發。
㈡ 開發人員為什麼不願意寫文檔
有以下幾點。
1.怕煩
程序員從入門之日起,就在心裡埋藏了一顆編程的種子,認為程序員就是編程序的,就是和計算機打交道的,程序就是程序員的全部。無論是在編程之前寫文檔,還是在編程之後寫文檔。他們都認為寫文檔很煩人。
1)文檔種類太多。越正規越多。一想到要寫那麼多的文檔,程序員的頭都要大了。
2)文檔寫作要求不低。有格式要求、內容要求,還需要畫各種流程圖、示意圖、關系圖、界面圖和填寫各種表格說明,以及要收集各種資料。雖然沒有技術含量,但是要花的時間比編程序多,而且也不一定能寫好。
3)在正規的開發公司中一般一個變更就要編寫一系列的變更文檔。當不斷變更時,只有最後的變更文檔是最重要的。當我們不知道當前是不是最後一個文檔時,我們就不願意寫可能被後面的文檔替代的文檔。
4)當寫了文檔之後,就會不斷有使用文檔的人來詢問細節,這些詢問往往會讓人崩潰。這是因為很難寫出讓每個人都提不出問題的文檔。
2.沒空
在很多情況下,程序員都處於一種「時間緊、任務重」狀態。在急於得出編程結果的驅使下,程序員一心撲在編程上,恨不得一分鍾一個變化,哪有心思和時間先把文檔寫好再去編程呢?即使他們擁有先把程序編出來,然後再補寫文檔的想法,但是一旦他們完成一段程序之後,就會立即撲向第二段程序。如此下來,編寫文檔只能放在項目開發的後期了。你要是真的寫文檔,那寫文檔的時間早已將編程時間給擠佔了,你的編程工作就完不成了。
㈢ 有沒有專門為程序員寫文檔的工作
兄弟,你若果真能有如此的悟性,足以成為一名出色的程序員!
㈣ 程序員的文檔一般是怎樣寫的
www.csdn.net
㈤ java程序員需要些什麼文檔
我很少寫文檔,懶得寫,除非項目有要求
對於文檔這個東西簡單談一下
做項目之前就有文檔
這個是可遇不可求的,現在做的項目很多都是臨時突然說要做的,什麼需求都沒有,只能靠程序員自己去發現,項目經理的要求,客戶的臨時需求(這個比較痛苦,他們有時候根本就不知道要什麼,所以必須寫好文檔,跟客戶談好,不然又要變的時候,你就痛苦了)
如果項目一開始就有文檔,當然也可能是你自己寫的,也可能是其他人寫好的,有些公司有人專門負責寫,需求分檔,項目分析文檔,項目結構文檔,資料庫文檔等等,不過之後可能需要你寫測試文檔,這個就沒有聽說過誰幫你做了,但是更多的情況也是不用寫,就幾個功能,自己和測試人員測測就算了,也有可能需要寫使用文檔,這個看情況了
做項目之前沒有文檔
如果項目緊張,根本就不會寫任何文檔,但是當項目結束的時候,你又沒有項目做,項目精靈可能就讓你寫寫文檔打發打發時間,
文檔對於公司來說是很重要的,但是對於個人的話,就要看情況,如果你做了很多項目,其實什麼文檔也不需要,你大體上都知道這個項目就做什麼用的,怎麼架構的,那些代碼是什麼意思(你的編程習慣很好的情況下),所以很多公司都會要求程序員寫文檔,不然你走的時候,別的人怎麼接受,讓別人理解你的思想是很痛苦的,每個人的思想都是不一樣的
㈥ Java程序員,你們在項目里寫文檔么
恩,要寫,
這是你做項目前的預備工作啊~
你瞧我們在每學期最後做項目都要交的文檔就有20來個包括軟體系統分析,測試用例,系統設計報告等等一些。
一個文檔就得發上那麼2周的時間。
說老實話,如果一個項目沒有做項目文檔,那麼那個軟體將來出來一定會有很多的BAG。
㈦ 為什麼程序員不願寫文檔
其中的原因很多,我自己歸納了幾點:
1.怕煩
程序員從入門之日起,就在心裡埋藏了一顆編程的種子,認為程序員就是編程序的,就是和計算機打交道的,程序就是程序員的全部。無論是在編程之前寫文檔,還是在編程之後寫文檔。他們都認為寫文檔很煩人。
1)文檔種類太多。越正規越多。一想到要寫那麼多的文檔,程序員的頭都要大了。
2)文檔寫作要求不低。有格式要求、內容要求,還需要畫各種流程圖、示意圖、關系圖、界面圖和填寫各種表格說明,以及要收集各種資料。雖然沒有技術含量,但是要花的時間比編程序多,而且也不一定能寫好。
3)在正規的開發公司中一般一個變更就要編寫一系列的變更文檔。當不斷變更時,只有最後的變更文檔是最重要的。當我們不知道當前是不是最後一個文檔時,我們就不願意寫可能被後面的文檔替代的文檔。
4)當寫了文檔之後,就會不斷有使用文檔的人來詢問細節,這些詢問往往會讓人崩潰。這是因為很難寫出讓每個人都提不出問題的文檔。
2.沒空
在很多情況下,程序員都處於一種「時間緊、任務重」狀態。在急於得出編程結果的驅使下,程序員一心撲在編程上,恨不得一分鍾一個變化,哪有心思和時間先把文檔寫好再去編程呢?即使他們擁有先把程序編出來,然後再補寫文檔的想法,但是一旦他們完成一段程序之後,就會立即撲向第二段程序。如此下來,編寫文檔只能放在項目開發的後期了。你要是真的寫文檔,那寫文檔的時間早已將編程時間給擠佔了,你的編程工作就完不成了。
3.沒有用
文檔的重要性其實對不同對象是不一樣的。如果你說文檔沒有用,立即會有人用唾沫把你淹死,他們立即會搬出哪個哪個說文檔是重要的,文檔是不可缺的。唯獨不敢說「我自己認為文檔是重要的」。這也反過來說明文檔的有用性程度對不同人是不一樣的。對於程序員來說,只要能把程序編出來就行了。很多程序員不寫文檔照樣編出程序來,在他們的觀念中文檔不寫也罷。如果按文檔編程序,那就要確保文檔的正確性、不可更改性。而實際上,文檔不如編程快,編程不如變化快,不斷變化的需求和代碼讓文檔如同一張過時的廢紙一樣。
在現實中,有的文檔變成了項目開發後的總結,對開發本身並不起作用,只是保留一個存在的形式,以應付各種各樣規范的需要。在這種情況下,文檔沒有任何實用價值,所以即使程序員寫了,也沒有什麼作用。尤其是項目投產後,幾經升級,最初的文檔早已和現實的情況對不上號了,文檔更新和系統的一致性更是難於控制。
4.沒好處
既然認為編程序才是正道,那麼程序員寫文檔就是一種額外和輔助的工作,做了就做了,對於程序員來說沒有任何好處。
當然,文檔的好處更多地體現在軟體公司、單位、軟體用戶、後續程序員身上,它是一種「前人栽樹,後人乘涼」的好事。所以程序員不願意寫文檔。
文檔有多麼重要呢?有人把它上升到「程序員頭腦的拷貝」的高度,有的人甚至說,程序員走了後,只要有了文檔,軟體公司可以再招新人,公司照樣運轉起來。如此說來,天性聰明的程序員會把文檔寫得清清楚楚嗎?
5.不會寫
從寫作本身來看,寫好一篇文檔不是一件容易的事。文檔有文檔的格式和寫作要求。現在的人只喜歡動嘴說事,沒有多少人在平時會動筆寫字,更不用說寫文章了。所以,寫文檔從理論上來說也是需要學習和訓練的,需要在平時進行寫作積累。當要求一些程序員寫文檔的時候,他往往會回答你:「怎麼寫呀?我不會。」你不會寫可以不怪你,你不去學,反而理直氣壯地說不會,則是你的不對了。難道那些會寫文檔的人都是「獃子」嗎?難道他們不懂幹活辛苦的道理嗎?
當一個男子向一個自己喜歡的女子示愛,需要用情書來表白的時候,難道他不會寫情書嗎?即使他不會寫,他也一定會克服千難萬險把情書寫出來的,這是他的主觀使然。如果程序員主觀上想寫文檔,怎麼會怕煩?怎麼會怕沒空?怎麼會怕文檔沒有用?怎麼會怕不會寫?這些怕其實都是借口。真正優秀的程序員應該不單是編程的高手,同時也應該是寫文檔的高手。
程序員真正不喜歡寫文檔的原因是:文檔是給別人看的,不是給自己看的。如果要使程序員喜歡寫文檔,那就要提高程序員的意識和境界,或者要給寫文檔的程序員以獎勵。而靠制度、管理讓程序員去寫文檔只能是一種職業上的弊端。當有一天寫文檔也成為一個專業化的崗位,程序員和文檔人員分開時,程序員就會一心一意看文檔寫代碼,文檔員就會以此為職業,一心一意寫文檔拿工資。我們將不再為此進行討論。這種分工一定是未來的趨勢。一些大的公司或管理規范的公司都已經有這樣的分工了。只是很多中小軟體公司或企事業單位里的IT部門還沒有專業化到如此程度。程序員不喜歡寫文檔也許說明他們不願意承擔太多的角色吧。
不管怎麼說,作為一個程序員(尤其想成為優秀程序員)一定要學會寫文檔,一定要學會欣賞文檔。無論你是否喜歡,你都應該可以在文檔的各種問題面前可進可退。可以這樣說,那些既不會寫文檔,又不會欣賞文檔的程序員是沒有資格說「我就不喜歡寫文檔」這種話的。
㈧ 程序員到底需不需要寫文檔
您好:
需要寫,而且需要好好寫。
不論是前期的設計文檔,開發文檔。
還是後期的測試文檔,實施文檔,用戶手冊,FAQ。
這些文檔是伴隨著整個工作來的。。。
降低溝通成本,提高溝通效率。。。
㈨ 我是個編程的自學者,想當程序員不知道公司寫文檔是什麼意思知道的情給我解釋一下,還有具體是怎樣工作的
以鄙人在軟體公司工作的經驗與你分享一下吧。
我們平時做項目,一般有一半以上時間都在管理文檔,包括基本設計書,詳細設計書,靜態樣式書,各種UML建模圖,單體測試書,系統測試數,結合測試書,DB設計書,DB腳本,以及各種工具類管理文檔,如資源文件管理,VBA管理等等,這還不包括項目前期的需求建設書,項目中期與客戶交流的反饋書,項目後期的BUG管理書,以及貫穿項目的工程進度表和版本控制書。當然你的代碼資源(包括注釋,圖片,腳本等)也屬於文檔,需要統一管理。
對於追求簡短快的團隊,未必會太重視文檔的組織與管理,但是一定要相信文檔看似浪費時間,其實無形中提高了很大的效率,而且在未來的開發提供了寶貴的參考資料。屬於團隊積累的一種。