看板Soft_Job
: ※ 引述《howshou (好小 )》之銘言:
: : 如果你真的有認真看過文件,你會越來越不相信文件。
: : 我記得前幾年我看約耳談軟體(Joel on Software)這本書時,
: : 覺得超有幫助的,果然任何變更都要有文件。先有文件再寫軟體。
: : 所有的專案管理經驗與書籍也會告訴你, 寫文件比寫程式重要。
: : 它們說得都對,你說的也對。
: : 但是我不知道為什麼,現實生活就是窒礙難行。
1. 工程人都不喜歡寫文件。這是真的,喜歡寫文件能寫文件的可能就不會走這條路。
2. 文件是為了承先啟後,如果我們想一輩子做底層的程式設計師,當然功能做好等下班
就好。
3. 文件寫到夠用,看得懂就好。使用一些共同編輯的工具減少文件的維護問題(譬如說
註解或wiki)。
4. 不要硬逼工程人員達到不可能的標準,反而要逐步教育,一次只要求多一點,反彈就
會比較小。
5. 從源頭開始,從程式碼註解開始,寫程式碼的人最熟程式碼,讓他們在習慣的地方寫
文件。
6. 使用自動化的軟體建立文件,教育程式人員寫Doxygen的註解,減少撰寫無謂的文件
的時間(類別,成員,定義等等)。
7. 從進程式碼(commit)的註記開始,確保每次的改動都知道為了什麼。也就是有些人
提倡寫User Story,一口氣沒辦法從無到有把完整的文件建出來,那就從每次改程式
發生了什麼事情開始,一次只寫一點,累積這些軌跡,一樣有他的效果。
8. 先寫文件,再開發。讓程式人員在還沒真正寫程式之前把規格,問題,以及要做的事
情都搞清楚。避免過度設計或做多餘的介面與功能。
9. 開發後,寫文件。補充介面的註解,為什麼要寫這個功能,撰寫Tutorial或Example
。讓其他人知道到底這個功能:為什麼,是什麼,該怎麼用。
10.找助理來幫忙寫註解/文件,讓程式人員沒有藉口。
11.文件是為了溝通,用嘴巴講都很簡單,用嘴巴講都說就是這樣沒錯,一寫下來清清楚
楚白紙黑字賴不掉,馬上就改口說其實我的意思不是這樣。
12.文件從寫完的那一刻開始就過時了,但是一個過時的文件都比沒有文件來的好。
--
"May the Balance be with U"(願平衡與你同在)
視窗介面遊戲設計教學,討論,分享。歡迎來信。
視窗程式設計(Windows CLR Form)遊戲架構設計(Game Application Framework)
遊戲工具設計(Game App. Tool Design )
電腦圖學架構及研究(Computer Graphics)
--
◆ From: 114.42.150.90
※ 批踢踢實業坊(ptt.cc)※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1333635633.A.8B2.html
→ francej:工程人如果不排斥寫文件基本上就是無敵了. 這種人很適合 04/05 22:27
→ francej:拔擢到管理職. 對下壓得住工程師(我也是懂技術的...)對上 04/05 22:28
→ francej:,對投資人也能應對自如 04/05 22:28
→ enthos:想做能從文字"養"出程式的系統。 04/05 22:50
推 ggg12345:說得很對.但助理能幫忙寫註解嗎?可能得靠同級的工程師 04/06 01:31
→ bndan:壓的住工程師是要比工程師具有更高的技術性= = 不是"也"懂 04/06 08:12
推 bobju:給個讚 04/06 12:51
→ ggg12345:劉邦帶韓信,但劉邦軍事技術不如韓信.呂后更不行但宰韓信! 04/06 18:41
推 bobju:歷史上不知隱瞞了什麼,呂后究竟憑什麼能夠宰韓信? 04/06 21:38
→ ggg12345:技術人員若自認技術高明必然忽略看來沒啥技術的,輕敵必死 04/06 22:10
→ bndan:歷史舉例? 問題在人在軍 你在陣前別人聽你的理由要不要先分 04/06 22:16
→ bndan:析一下? 回正題 就算用流傳的說法 劉邦和韓信是"視千里馬"的 04/06 22:17
→ bndan:情況...一般主管和工程師? 視千里馬? 你認真的? 老師跟學生 04/06 22:17
→ bndan:我反而比較信...(利益問題) 04/06 22:17
→ ggg12345:開公司就是合伙出資出人打天下.來個工程師說幹活領錢,公 04/06 22:28
→ ggg12345:司盈虧不管,薪水都得照給.當老板得分清敵人同志,那怎麼顧 04/06 22:31
→ ggg12345:工程師技術再如何高,也不會超級到令沒技術的視有的如寇仇 04/06 22:37
→ NDark:助理寫文件就是pair programming,一個動口一個動手. 04/08 13:05