[討論] 缺文件少註解，沒人清楚的系統如何維護？

[eori (浮光掠影)]

進來公司一個多月，被指派說要去修改一個系統。 該系統已經用了10年以上，文件寥寥
可數，代碼改得亂七八糟，註解只有幾行。我這個職位兩年內換了五個人，其他同事只知
道大概，問細節就說去看code。老闆一直認為這個系統很簡單，搞不懂為什麼沒人懂。請
問大家有沒有相似經驗，後來又是怎麼解決，可以給我當作參考，謝謝。

--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 101.15.41.205
※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1482042852.A.959.html
※ 編輯: eori (101.15.41.205), 12/18/2016 14:34:41
→ chuegou: 三年內6人經手的fw 我看了兩個月 改不動 打掉重來
推 longlyeagle: 跟老闆說你覺得系統架構太舊 應該用新技術砍掉重練
推 jj0321: QQ....我還無法打掉,要想辦法看懂且繼續用舊架構
→ ken1325: 那你就先分別測試每個功能，補上註解。
推 doranako: 老闆都麻覺得每個系統很簡單
→ doranako: 只能靠你重構跟寫文件啊
推 winken2004: 因為他是老闆
推 clarkman: 打掉最快，但很難說服老闆換掉已經跑了很久的程式
→ clarkman: 而且出包的話就只能自己扛了。建議把功能分割清楚，
→ clarkman: 逐步重寫各個模組，等到贏得老闆信任時再整個重購
推 kwpn: 說服不了就塊淘阿
推 abccbaandy: 老闆通常都不會接受"好好的"系統打掉重練吧...
推 iamshiao: 看版控，每次拆一點做實驗
推 vn509942: 七寶奇謀 尋找大密寶~~~~
推 bjj: 沒註解可能比較好……
推 maxqq: 叫老闆來寫，老闆覺得簡單
→ maxqq: 通常系統過於複雜，薪資跟不上，就叫老闆調薪
推 mathrew: 只能靠你慢慢註解了
推 Ekmund: 要看系統多大欸...
→ Ekmund: 我之前是把一些tool等級 了不起三五千行而已
→ Ekmund: 但如果是跟很多東西交互到 光要瞭解流程規則
→ Ekmund: 外加一堆歷史因素額外掛上去的阿哩阿渣...
→ Ekmund: 你一個新人要說服老闆整個打掉重做 難度很高喔@@
推 NvidiaCUDA: 分了啦
推 comesuck: 打掉吧
→ gino0717: 快逃
推 now99: 打掉 也要承擔 系統出錯的風險 沒老闆背書不要做
推 alog: 除非你經驗很足剛好又跟老闆很麻吉 不然你要重構是不可能
→ alog: 要就是細心的維護老闆覺得很簡單的系統 or 塊陶
→ s860134: 敝司都是 code review + 主管會逛 git ，不太可能發生...
→ s860134: 以你的狀況你要先知道這系統怎麼用，由上而下抓流程
→ s860134: 比較好看 code ，由下而上追 code 通常看很慢，易失焦
→ s860134: 進入點就是你使用系統的進入點，至少照一個使用流程來追
推 clanguage: 這表示你處在一個隨便的環境 要嘛跟著隨便 要嘛就改變
推 cphe: 看這份系統是不是經常需要做修改，還是偶而才需要有一點改動
→ cphe: 如果不常異動那就慢慢把它看懂，通常用了這麼久的東西打掉
→ cphe: 重練的代價太大，除非是有計畫性、老闆同意，要不然就像你說
→ cphe: 的歷史因素，很多問題你重練還是要再重解一次任務的
→ xdraculax: 註解不可信 code 不會說謊
→ xdraculax: 歷史悠久的系統常有很多不合常理的特殊處理，但卻偏偏
→ xdraculax: 是符合業務需求，問使用者管理者他們也無法敘述詳盡，
→ xdraculax: 重寫之前還是得先搞熟舊系統再說
→ robber1234: 動不動就說要把舊專案打掉,你做得完你就做吧,先開104
推 sunnydragon7: 沒註解QQ
→ bndan: $$多福利好: 慢慢把程式順完寫自己懂的文.保維護順利即可
→ bndan: $$少福利差: 隨便改最好沒版控.稱到找到馬後就讓他們繼續爛
推 BlockChain: 快逃吧
推 lemontea0328: 說很簡單的都只出一張嘴...
推 cerwvk: 通常會說簡單的,肯定不會是自己要跳下去寫的.
→ zelkova: 有總似曾相似感 塊陶吧...
推 luckydream: 同病相憐，我準備要逃了
推 blockcat: 慢慢看，一邊標註解啊