㈠ 程序員為什麼都不喜歡做文檔工作
主要的原因是因為程序員不會寫文檔,寫出來的文檔不符合規范。
寫文檔在軟體工程當中是非常重要的,CNN非常強調文檔的編寫,在CNN開發代碼是貫穿整個開發過程,記錄各種情況,以便追蹤,這是復雜的工作,有著詳細的編寫規范,是軟體成敗的關鍵,占整個開發工作量的30—40%,而代碼編寫只佔20%-30%。國外成熟的軟體企業大規模生產軟體是採用這種方式,中國的軟體開發很多還不成熟,只是幾個人憑興趣、愛好獨個編寫,弄得一塌糊塗。
中國絕大部分程序員都不會寫文檔!
㈡ 程序員在上班時,允不允許大量的看說明文檔來幫助寫程序
程序員日常開發工作,基本是上離不開閱讀文檔,這也是很多程序員喜歡兩個顯示器的原因。
項目方面
技術方面
是不是很多人都認為,如果在開發過程中,還要不斷地翻技術文檔,說明他的開發能力不扎實。其實不是這樣的。
首先IT行業技術升級換代的速度太快,當我們大多數公司還在用java8的時候,Java11都已經出來了。如果非得要程序員熟知每一個類、每一個方法,是很不現實的。
很多時候我們只需要了解有這么一個東西,作用是干什麼的,具體的細節可以在用的時候再去翻文檔,比如方法名字是什麼?參數有幾個,都是什麼類型的?
所以我們都習慣至少兩個電腦屏幕,一個屏幕寫代碼,一個屏幕看文檔;如果豪一些的話,再加一個屏幕展示日誌信息。
看文檔的屏幕要買豎屏!
我們團隊
我這幾年也帶過幾個團隊,對於每個團隊成員,我對他們的要求是:實現需求的前提下,最好能對所用的技術有一定的了解,千萬不要從網上抄過來一段代碼就用,這樣是很危險的行為。所以鼓勵大家多找一些資料,最好是閱讀框架的官方文檔。
現在的團隊,我已經這樣要求了:代碼寫累了,或者覺得自己沒有狀態寫代碼,可以找點兒自己有興趣的技術文檔學習學習,這個技術甚至是可以跟現在的項目沒有關系的。
首先,我不是程序員,我是一個設計工作者,不過我來說一下我的觀點:很多人以為程序員像電影里的一樣,啪啪啪幾下鍵盤,屏幕數據颼颼的變,其實真實情況是程序員寫代碼就像學生寫作文,也會遇到不會的詞語跟修辭手法,那這個時候就要停下來想一想,查一查,看看例子是怎樣寫的怎樣用的,寫錯了還要劃掉(刪掉)再來,至於這個大量不大量看的情況,如果這個是個新手,那肯定是可以的,那如果是個老手,還需要大量時間查說明文檔,那就說明這個項目肯定不會小,不是一兩天能做完的,那一個用月做單位的項目,用一個天做單位的時間來查文檔,不過分吧!程序員也是人,不是因為他的工作高端,就覺得這個人萬能,他也會當機,要吃飯,要休息,也會忘記一些東西,所以請各位多多體諒,能一起工作實屬不易,感恩2018,謝謝。
這個問題怎麼說呢,開發過程中會遇到各種各樣的問題,沒有一個人是全能的,也沒有人可以絕對的說自己在整個項目中不會遇到一點問題,不去查東西,自己大腦里的東西完全可以讓我把這個項目測測底底的做完,並且沒有任何bug。
上班的時間,也沒有老闆或者誰在後面一直看著你去做東西,大家都挺忙。文檔是幹嘛的,文檔本身就是用來看的,甚至很多項目開始之前,總監都會讓你去搜集一些這個項目可能會遇到的bug,可能會用到的效果,盡量在之前找到比較好用的插件,這樣會節省很多時間,自己如果寫代碼的話不可能百分百的確定沒有人和bug,但插件不一樣很多插件都是前輩通過很長時間慢慢完善出來的插件,所以很多人才會用。所以你提問的可以肯定的回答你允許。
程序員上班的主要工作就是看說明文檔,根據說明文檔編碼。如果實在沒有說明文檔,有時還得親自披掛上陣寫說明文檔。
寫介面的有API文檔,寫通訊協議的有協議欄位說明文檔,寫資料庫的有資料庫規範文檔,
總之任何一個大公司文檔扮演的一個至關重要的問題,因為形不成文檔,公司管理就會陷入混亂不堪的局面,當某個核心員工離職後,下一個接盤的程序員會丈二和尚摸不著頭腦,一頭霧水,邊填坑邊罵娘,有了文檔就可以看文檔結合代碼,了解其中模塊邏輯以及結構,包括哪些坑不能踩等等好處。有些公司會專門有文檔工程師這個職位來專門負責整理各種文檔,並且保存在伺服器上。
好的文檔都是程序員等人智慧的結晶,是一盞指路明燈,是一條通往光明的道路。程序員不能看說明文檔等於在黑暗裡摸爬滾打,有了說明文檔才迎來了黎明的曙光。
說個我遇到的2個真事吧,
第一個,公司找的外包公司寫項目程序,已經要交付了,發現有幾個功能沒做,產品經理和開發那邊都找我,我一個搞運維的又不懂,只能讓他們去對開發文檔,我也就順便看了看,開發文檔中明確的寫明怎麼做,然後就讓他們就重新按開發文檔繼續寫,
另一個,由於 歷史 原因業務系統處於託管狀態,只有部分參考文檔可用,開發那邊只能按當前已有文檔進行開發參考,開發那邊也一直在根據現有相關文檔進行開發,杯具的是這幫子不仔細看,有問題總想著我能直接給他們答案,我也只是會用而已,開發我還真搞不來,然後和他們一起看開發文檔,加密演算法部分給她們指出後,問題解決了。
所以我覺得,開發團隊在開發中很有必要閱讀開發文檔,這可以避免繞圈子,也會清楚開發文檔中提供的內容。
先說觀點,我認為看文檔沒什麼問題,但是「大量」這個程度很難衡量,按照需要看文檔是個非常重要的事情。
需要花費時間的情況 不需要花費大量時間的情況 小結
在工作中閱讀文檔其實也是工作內容的一部分,而且現在大多數互聯網公司都靠KPI進行考核,平時就算你把時間都用來看文檔沒關系,最後KPI沒完成一樣會被公司淘汰。所以公司不會阻攔你花費時間看文檔,最多你老闆會提醒你浪費這么多時間看文檔而沒有實際的產出會對你年終考核造成影響罷了。
題主對文檔的定義不是很明確
第一個是需求說明文檔
這個是在開發過程中必不可少的文檔,只有清楚了開發需求,程序員高效率的開發,程序員一天的工作時間並不是都是在寫代碼,而是在看文檔,了解需求,理清思路,只有什麼都清楚了,寫代碼或許只要十幾分鍾。
再者對於一個項目新人來說不看文檔了解需求,沒人給你從頭到尾的在講一遍需求,你不看文檔自己發揮?進入項目是和別人共同開發,你不肯能不顧及之前的代碼規范。
第二個是開發文檔
就拿微信開發來說,微信開發不是每個程序員必須會的東西,但是用到了怎麼辦,還不是去看他們的開發文檔,只有將開發文檔思路理清楚了,才可以進行下一步開發。
第三個是API文檔
在前後端分離的開發模式中API文檔是必不可少的文檔。不看API不知道數據是什麼樣。也就是不可能順利的和後端進行結合。
兄dei,假設你是程序員,你在寫程序時,旁邊會有人守著你嗎?
假設你不是程序員,你在做本職工作時,旁邊會有人守著你看你怎麼做事嗎?
答案肯定是沒有的。誰會閑著招個人去監督你,看你用什麼方式去完成給你的任務。
所以,其實你看不看大量文檔,沒有人會在乎,關鍵是你自己,建議自己寫東西時,不要一味的復制粘貼,要有自己的想法。太依賴文檔對於自己成長很不利
當然允許看文檔。
要知道,隨便哪個類庫,都有無數的類和方法,每個方法又有若干參數,鬼知道它們都是什麼意思,誰的腦子能記得那麼多內容。別說是人家提供的類庫,就是自己寫的代碼,過一段時間也不記得什麼意思了。沒有注釋和文檔,怎麼看懂代碼?
如果沒有需求分析文檔,程序員怎麼理解正在開發的這個軟體的基本業務流程?
如果沒有架構設計文檔,程序員怎麼理解軟體各個功能模塊之間的功能與業務邏輯?
如果沒有介面文檔,那麼多類和方法,都怎麼調用,會返回什麼值,難道靠猜?
……
在日常開發工作中,不僅允許看文檔,還會強迫你寫文檔。如果你寫的文檔別人看不懂,別怪領導罵你不認真。文檔對於軟體開發的重要性是不言而喻的。
還有一個秘密告訴你,那些經常寫文檔的程序員,要比不寫文檔的程序員工資更高。
真的!!!
迎娶白富美,從會寫文檔開始!
這個問題要根據具體開發的功能模塊來看,不過原則來說,花大量的時間看說明文檔,至少給人的印象是經驗不夠豐富,開發能力有待提高。
具體來說,如果是普通的功能開發,技術挑戰不大,這種如果還要看文檔,會被認為是開發能力問題。如果是有一定的技術挑戰,公司在這方面的積累比較少,開發團隊也對此有共識,這種問題看文檔無可厚非,當然如果能業余時間學習相關的知識,會給團隊留下開發能力強的印象。對於一些前瞻性研究,公司沒有任何技術積累,或者全新的技術方向,這個看說明文檔是加分的,甚至可以要求公司購買相關書籍或者在線培訓,當然,自己啃下來會更NB。
㈢ 我是以java程序員進的公司。但是為何給我安排了寫文檔的工作
首先確定自己寫文檔的類型,寫文檔有很多種
技術類文檔
需求類文檔
行政類文檔
或者說分類:
與項目相關的
與項目無關的
就看你寫的是那類型文檔了,還有時長的問題,如果你在公司都呆了1年了,還是寫一些無關緊要的文檔,偏離你最初的目的,肯定就不能再繼續帶下去了撒
㈣ 程序員的工作的具體內容是什麼
你是程序員?
㈤ 程序員在哪裡寫文檔
GitHubPages。
現在大多程序員都會使用通用代碼庫Github,所以對於希望保存文檔的程序員來說,Github是一個不錯的選擇,盡管很多人只是利用代碼庫中的readme功能來為項目提供簡單的操作指南,但這並非是最好的辦法。
ReadtheDocs。
顧名思義,ReadtheDocs為開發人員提供了一個集中的平台來保存文檔,這樣用戶就可以直接閱讀文檔了。它的工作原理有點類似GitHubpages,因為開發人員可以從他們喜歡的版本控制系統(包括Git、Bazaar、Mercurial等)中推送文檔更新。
㈥ 程序員的具體工作是什麼
確認通過審查方案的目標,輸入數據,分析師,監事,和客戶的輸出要求的項目要求。
安排項目要求在編程序列分析要求;准備工作流程圖和使用計算機知識的能力,題材,編程語言和邏輯圖。
編碼工作流程的信息轉換成計算機語言的項目要求。
通過輸入編碼信息的計算機程序。
確認程序操作進行測試,修改程序序列和/或代碼。
准備寫操作指令供用戶參考。
保持歷史記錄,通過記錄方案的制定和修訂。
維護客戶的信心和保護保密的業務。
技能/資格:一般的編程技巧,分析信息,解決問題,軟體演算法設計,軟體性能優化,注重細節,軟體設計,軟體調試,軟體開發基礎,軟體文檔,軟體測試。程序員其實分為很多種,大家開發的語言可能不盡相同,但是都是有他們的共同點。
㈦ 程序員工作要做什麼
程序員(英文Programmer)是從事程序開發、維護的專業人員。一般我們將程序員分為程序設計人員和程序編碼員,但兩者的界限並不非常清楚,特別是在中國。
作一個真正合格的程序員,應該具有的素質。
1:團隊精神和協作能力
團隊精神和協作能力是作為一個程序員應具備的最基本的素質。軟體工程已經提了將近三十年了,當今的軟體開發已經不是編程了,而是工程。獨行俠可以寫一些程序也能賺錢發財,但是進入研發團隊,從事商業化和產品化的開發任務,就必須具備這種素質。可以毫不誇張的說這種素質是一個程序員乃至一個團隊的安身立命之本。
2:文檔習慣
文檔是一個軟體系統的生命力。一個公司的產品再好、技術含量再高,如果缺乏文檔,知識就沒有繼承,公司還是一個來料加工的軟體作坊。作為代碼程序員,必須將30%的工作時間寫用於技術文檔。沒有文檔的程序員勢必會被淘汰。
3:規范化的代碼編寫習慣
知名軟體公司的代碼的變數命名、注釋格式,甚至嵌套中行縮進的長度和函數間的空行數字都有明確規定,良好的編寫習慣,不但有助於代碼的移植和糾錯,也有助於不同技術人員之間的協作。 一些所謂的高手甚至叫囂高手寫的代碼一般人看不懂,我只能說他不是一名合格的程序員。
4:需求理解能力
程序員要能正確理解任務單中描述的需求。在這里要明確一點,程序員不僅僅要注意到軟體的功能需求,還應注意軟體的性能需求,要能正確評估自己的模塊對整個項目中的影響及潛在的威脅,如果有著兩到三年項目經驗的熟練程序員對這一點沒有體會的話,只能說明他或許是認真工作過,但是沒有用心工作。
5:模塊化思維能力
作為一個優秀的程序員,他的思想不能在局限當前的工作任務裡面,要想想看自己寫的模塊是否可以脫離當前系統存在,通過簡單的封裝在其他系統中或其他模塊中直接使用。這樣做可以使代碼能重復利用,減少重復的勞動,也能是系統結構越趨合理。模塊化思維能力的提高是一個程序員的技術水平提高的一項重要指標。
6:測試習慣
測試是軟體工程質量保證的重要環節,但是測試不僅僅是測試工程師的工作,而是每個程序員的一種基本職責。程序員要認識測試不僅是正常的程序調試,而要是要進行有目的有針對性的異常調用測試,這一點要結合需求理解能力。
7:學習和總結的能力
程序員是很容易被淘汰的職業,所以要善於學習總結。許多程序員喜歡盲目追求一些編碼的小技巧,這樣的技術人員無論學了多少語言,代碼寫起來多熟練,我們只能說他是一名熟練的代碼民工,他永遠都不會有質的提高。一個善於學習的程序員會經常總結自己的技術水平,對自己的技術層面要有良好的定位,這樣才能有目的地提高自己。這樣才能逐步提高,從程序員升級為軟體設計師、系統分析員。
作為高級程序員,乃至於設計師而言,除了應該具備上述全部素質之外,還需要具備以下素質:
1、 需求分析能力
2、 整體框架能力
3、 流程處理能力
4、 模塊分解能力
5、 整體項目評估能力
6、 團隊組織管理能力
一般招工時需要提供基礎程序員證書,要參加考試的:
[編輯本段]考試說明
1、 考試要求:
(1) 熟練掌握基本演算法和數據結構,用C語言編製程序;
(2) 掌握數據結構、程序變速器和操作系統的基礎知識;
(3) 了解軟體工程、資料庫、多媒體和網路的基礎知識;
(4) 掌握數制、機內代碼及其算術運算和邏輯運算的基礎知識;
(5) 了解計算機的體系結構和主要部件的基礎知識。
2、 通過本級水平考試的合格人員能按照軟體設計說明書編製程序,具有相當於助理工程師
的實際工作能力和業務水平。
3、 本級水平考試范圍包括兩個模塊:模塊1——程序編制能力(考試時間為150分鍾);模
塊2——基礎知識(程序員級)考試時間為120分鍾)。題型為:單項選擇題十多項選擇題。
㈧ 計算機程序員主要是做什麼工作的
程序員是從事程序開發、維護的專業人員。
㈨ 我是個編程的自學者,想當程序員不知道公司寫文檔是什麼意思知道的情給我解釋一下,還有具體是怎樣工作的
以鄙人在軟體公司工作的經驗與你分享一下吧。
我們平時做項目,一般有一半以上時間都在管理文檔,包括基本設計書,詳細設計書,靜態樣式書,各種UML建模圖,單體測試書,系統測試數,結合測試書,DB設計書,DB腳本,以及各種工具類管理文檔,如資源文件管理,VBA管理等等,這還不包括項目前期的需求建設書,項目中期與客戶交流的反饋書,項目後期的BUG管理書,以及貫穿項目的工程進度表和版本控制書。當然你的代碼資源(包括注釋,圖片,腳本等)也屬於文檔,需要統一管理。
對於追求簡短快的團隊,未必會太重視文檔的組織與管理,但是一定要相信文檔看似浪費時間,其實無形中提高了很大的效率,而且在未來的開發提供了寶貴的參考資料。屬於團隊積累的一種。