Re: [討論] 如何補救文件不完整專案

[JasperChang (PeterChou)]

※ 引述《joejoe14758 (噓文也可以很溫柔)》之銘言
: 原標題：如何維護商業邏輯
: ------------------------------------------
: 大家好
: 最近碰到的情況覺得很麻煩
: 像是常常PM不知道某段的商業邏輯是什麼
: 就來問我 常常我也不知道/忘記了 只能去翻翻code
: 因為頻率蠻高的 有時候覺得自己是客服
: 我知道商業邏輯應該要寫在規劃書/規格上
: 但實際狀況可能時間太趕或種種原因導致沒有被記錄到/不完整
: 想請問大家都是怎麼避免/改善這個情況的呢 謝謝

先說結論：不需要補救，管他去死

文件這種東西就是不計入績效，

最多成為點綴 KPI 的東西

寫一份好的技術文件就像概論教科書

讀者看了舒服 爽

但寫作者花了許多精力時間 回報趨近於零

有那個閒工夫不如多鑽研技術 多開發功能

愈是高階、薪水愈高的開發者

愈會跟你說技術文件開發文件很重要

但寫作的永遠不是他 他要花費時間提升自己

認真寫文件的你不知不覺就因為浪費時間

在專業道路上遠遠落後

一種人例外 就是專門嘴炮指導架構的管理者

他們不是專業的軟體架構師

領著豐厚的薪水 產出華麗的文件

卻常常讓實作者覺得有病

所以 聰明的開發者請多為自己的人生想想

如果你不是擁有大量技術股

請不要浪費生命寫文件為人作嫁了

要爛 一起爛


--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 36.225.184.172 (臺灣)
※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1609609128.A.97F.html
推 wintersxp: 中肯，感同身受，但我醒得太晚，人生已經廢了
→ jej: 金融業還會有人靠腰你寫錯字 字體弄錯 頁數沒有refresh
→ jej: 幹 我就不相信稽核會來查核這些毛
推 Nitricacid: 中肯
推 aidansky0989: 命名做好註解寫重點，沒文件至少不會太慘
→ sharek: 如果你所謂的專業道路只侷限於技術開發，自然不會重視
推 OriginStar: 國內認為的專業就是技術開發阿，對於軟體工程的方法論
→ OriginStar: 當然就顆顆
推 now99: 不去補文件，只是挖洞給後人或一段時間後的自己而已
噓 alihue: 歪理
歪理？花錢啊！哪個公司不追人進度讓人好好處理精美文件算績效的，還是你就是那種拗人
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:19:17
大公司小公司九成九要你自己 trace code 啦
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:20:56
推 csieflyman: 自己私下隨手寫筆記給自己查就好 就不必浪費時間管排
→ csieflyman: 版格式及完整性
推 hanshsu: 稽核好像真的會對喔 我同事上次schema寫錯字被開單了
推 joejoe14758: 我是原po 謝謝分享 這觀點以前沒有想過 會再想想的
→ joejoe14758: 謝謝
→ joejoe14758: 感覺上層不push這件事 那這件事情就不會有改善的機會
→ joejoe14758: 了
噓 alihue: 剛好我公司不追人進度欸
→ alihue: 公司
→ alihue: 自己待的公司扭曲成這樣別認為其他公司都這樣搞，多出去
→ alihue: 別間公司看看吧
→ alihue: 我在台北待的公司
→ alihue: 也都沒在看績效和催進度謝謝
→ alihue: 同事們都在自動自發工作，誰在跟你凹人
你才多去別家公司看看咧，懶的理你
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:40:44
→ samuel1988: 喔 廢文
→ samuel1988: 你不寫文件怎麼整理架構和系統設計
→ samuel1988: 一輩子碼農典範
→ samuel1988: 你沒有文件怎麼溝通？你到底在哪家公司可以講一講
推 layan: 中肯
→ samuel1988: 你技術到頂能幫助團隊往前嗎
推 yamakazi: 還好我們公司算績效可以拿文件來抵，一堆人尤其主管不寫
→ yamakazi: 扣只寫文件
推 yamakazi: 如果跟日商公司合作過，你會發現日商特愛寫文件
→ yamakazi: 什麼8D, 5 why,好像都是toyota搞出來的那一套。有發現bu
→ yamakazi: g後都會叫你寫檢討報告
→ yamakazi: 發哥也會叫人寫PDCA
噓 as30385438: 同意自己待的公司扭曲別以為大家都這樣，我公司寫文
→ as30385438: 件就是開ticket列入正式工作，這不做就是讓專案慢性
→ as30385438: 死亡而已
→ t64141: 環境對寫文件是否友善是一回事，歸納成文件無用/有害就很
→ t64141: 奇怪了
→ t64141: 寫文件的過程是需要思考的，會有更多機會重新檢視設計是
→ t64141: 否恰當，後人看了也比較能知道當下這樣設計的原因，有機
→ t64141: 會避免不清楚歷史背景而改錯
→ t64141: 且依你這論點，真遇到所謂九成九以外的公司可能也進不去
→ t64141: ，而且你可能不會知道原因，接著繼續歸納出九成九公司不
→ t64141: 重視文件...
噓 CureYou: 好嗆
→ dream1124: 推t64141 而且寫文件不計入工時的話應該向上反應才對吧
→ dream1124: 哪有人上班有工作不算工時，叫你想辦法生時間做的
噓 cokellen: ....
→ jack0204: 所以你認為產糞code才是工作對不對
→ airtsubasa: 原文很貼近職場啊，在台某假日商就是這種狀況，又很愛
→ airtsubasa: 輪調，無基礎程式能力的人接專案改程式
噓 MoonCode:
→ sayya2311: 不需有文件時就不用文件啊,你看滿天的open source有完
→ sayya2311: 整文件的了了無幾, 有文件前先問為什麼需要文件吧..
→ alihue: 文件是對程式一個很好的 overview，先有概念再    trace
→ alihue: code 會好上手很多。更別說有些是含有特地領域的知識，這
→ alihue: 時若沒文件，給你 debug mode 下斷點你還是不知道為什麼
→ alihue: 要這樣
推 kingofsdtw: 代表系統還不夠大吧
推 hellomotogg: 血尿推推
噓 sorryla: Google要升Senior有很大一部分的評比就是寫文件
→ airtsubasa: 可是你不在google阿！
→ viper9709: 不是這樣吧~沒寫文件以後回來連自己都看不懂
→ sorryla: 樓樓上，我之前在Google
→ alihue: 樓上 XD
推 airtsubasa: 那很好啊！不過發文者在鬼島吧
推 ms0443001: 鬼島資訊日常
噓 Raymond0710: 歪風討噓