看板 Soft_Job作者 eori (浮光掠影)標題 [討論] 缺文件少註解，沒人清楚的系統如何維護？時間 Sun Dec 18 14:34:10 2016
進來公司一個多月，被指派說要去修改一個系統。 該系統已經用了10年以上，文件寥寥
可數，代碼改得亂七八糟，註解只有幾行。我這個職位兩年內換了五個人，其他同事只知
道大概，問細節就說去看code。老闆一直認為這個系統很簡單，搞不懂為什麼沒人懂。請
問大家有沒有相似經驗，後來又是怎麼解決，可以給我當作參考，謝謝。
--
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 101.15.41.205
※ 文章代碼(AID): #1OLYtabP (Soft_Job)
※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1482042852.A.959.html
※ 同主題文章:
[討論] 缺文件少註解，沒人清楚的系統如何維護？
12-18 14:34 eori.
※ 編輯: eori (101.15.41.205), 12/18/2016 14:34:41
→ chuegou: 三年內6人經手的fw 我看了兩個月 改不動 打掉重來1F 12/18 14:41
推 jj0321: QQ....我還無法打掉,要想辦法看懂且繼續用舊架構3F 12/18 14:46
→ ken1325: 那你就先分別測試每個功能，補上註解。4F 12/18 15:02
推 doranako: 老闆都麻覺得每個系統很簡單
只能靠你重構跟寫文件啊5F 12/18 15:03
推 clarkman: 打掉最快，但很難說服老闆換掉已經跑了很久的程式
而且出包的話就只能自己扛了。建議把功能分割清楚，
逐步重寫各個模組，等到贏得老闆信任時再整個重購8F 12/18 15:46
推 kwpn: 說服不了就塊淘阿11F 12/18 16:00
推 abccbaandy: 老闆通常都不會接受"好好的"系統打掉重練吧...12F 12/18 16:32
推 vn509942: 七寶奇謀 尋找大密寶~~~~14F 12/18 17:44
推 bjj: 沒註解可能比較好……15F 12/18 18:00
推 maxqq: 叫老闆來寫，老闆覺得簡單
通常系統過於複雜，薪資跟不上，就叫老闆調薪16F 12/18 18:01
推 mathrew: 只能靠你慢慢註解了18F 12/18 19:19
推 Ekmund: 要看系統多大欸...
我之前是把一些tool等級 了不起三五千行而已
但如果是跟很多東西交互到 光要瞭解流程規則
外加一堆歷史因素額外掛上去的阿哩阿渣...
你一個新人要說服老闆整個打掉重做 難度很高喔@@19F 12/18 19:34
推 now99: 打掉 也要承擔 系統出錯的風險 沒老闆背書不要做27F 12/18 21:12
推 alog: 除非你經驗很足剛好又跟老闆很麻吉 不然你要重構是不可能
要就是細心的維護老闆覺得很簡單的系統 or 塊陶28F 12/18 22:11
→ s860134: 敝司都是 code review + 主管會逛 git ，不太可能發生...以你的狀況你要先知道這系統怎麼用，由上而下抓流程
比較好看 code ，由下而上追 code 通常看很慢，易失焦
進入點就是你使用系統的進入點，至少照一個使用流程來追30F 12/18 22:13
推 clanguage: 這表示你處在一個隨便的環境 要嘛跟著隨便 要嘛就改變34F 12/18 22:45
推 cphe: 看這份系統是不是經常需要做修改，還是偶而才需要有一點改動如果不常異動那就慢慢把它看懂，通常用了這麼久的東西打掉重練的代價太大，除非是有計畫性、老闆同意，要不然就像你說的歷史因素，很多問題你重練還是要再重解一次任務的35F 12/18 23:42
→ xdraculax: 註解不可信 code 不會說謊
歷史悠久的系統常有很多不合常理的特殊處理，但卻偏偏是符合業務需求，問使用者管理者他們也無法敘述詳盡，重寫之前還是得先搞熟舊系統再說39F 12/19 04:13
→ robber1234: 動不動就說要把舊專案打掉,你做得完你就做吧,先開10443F 12/19 09:26
→ bndan: $$多福利好: 慢慢把程式順完寫自己懂的文.保維護順利即可$$少福利差: 隨便改最好沒版控.稱到找到馬後就讓他們繼續爛45F 12/19 16:17
推 cerwvk: 通常會說簡單的,肯定不會是自己要跳下去寫的.49F 12/20 21:46
→ zelkova: 有總似曾相似感 塊陶吧...50F 12/20 22:41
--