作者JasperChang (PeterChou)
看板Soft_Job
標題Re: [討論] 如何補救文件不完整專案
時間Sun Jan 3 01:38:46 2021
※ 引述《joejoe14758 (噓文也可以很溫柔)》之銘言
: 原標題：如何維護商業邏輯
: ------------------------------------------
: 大家好
: 最近碰到的情況覺得很麻煩
: 像是常常PM不知道某段的商業邏輯是什麼
: 就來問我 常常我也不知道/忘記了 只能去翻翻code
: 因為頻率蠻高的 有時候覺得自己是客服
: 我知道商業邏輯應該要寫在規劃書/規格上
: 但實際狀況可能時間太趕或種種原因導致沒有被記錄到/不完整
: 想請問大家都是怎麼避免/改善這個情況的呢 謝謝
先說結論：不需要補救，管他去死
文件這種東西就是不計入績效，
最多成為點綴 KPI 的東西
寫一份好的技術文件就像概論教科書
讀者看了舒服 爽
但寫作者花了許多精力時間 回報趨近於零
有那個閒工夫不如多鑽研技術 多開發功能
愈是高階、薪水愈高的開發者
愈會跟你說技術文件開發文件很重要
但寫作的永遠不是他 他要花費時間提升自己
認真寫文件的你不知不覺就因為浪費時間
在專業道路上遠遠落後
一種人例外 就是專門嘴炮指導架構的管理者
他們不是專業的軟體架構師
領著豐厚的薪水 產出華麗的文件
卻常常讓實作者覺得有病
所以 聰明的開發者請多為自己的人生想想
如果你不是擁有大量技術股
請不要浪費生命寫文件為人作嫁了
要爛 一起爛
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 36.225.184.172 (臺灣)
※ 文章網址: https://webptt.com/m.aspx?n=bbs/Soft_Job/M.1609609128.A.97F.html
1F：推 wintersxp: 中肯，感同身受，但我醒得太晚，人生已經廢了01/03 08:13
2F：→ jej: 金融業還會有人靠腰你寫錯字 字體弄錯 頁數沒有refresh01/03 09:28
3F：→ jej: 幹 我就不相信稽核會來查核這些毛01/03 09:28
4F：推 Nitricacid: 中肯01/03 10:48
5F：推 aidansky0989: 命名做好註解寫重點，沒文件至少不會太慘01/03 11:00
6F：→ sharek: 如果你所謂的專業道路只侷限於技術開發，自然不會重視01/03 11:01
7F：推 OriginStar: 國內認為的專業就是技術開發阿，對於軟體工程的方法論01/03 11:10
8F：→ OriginStar: 當然就顆顆01/03 11:10
9F：推 now99: 不去補文件，只是挖洞給後人或一段時間後的自己而已01/03 11:43
10F：噓 alihue: 歪理01/03 12:02
歪理？花錢啊！哪個公司不追人進度讓人好好處理精美文件算績效的，還是你就是那種拗人
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:19:17
大公司小公司九成九要你自己 trace code 啦
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:20:56
11F：推 csieflyman: 自己私下隨手寫筆記給自己查就好 就不必浪費時間管排01/03 12:26
12F：→ csieflyman: 版格式及完整性01/03 12:26
13F：推 hanshsu: 稽核好像真的會對喔 我同事上次schema寫錯字被開單了01/03 12:27
14F：推 joejoe14758: 我是原po 謝謝分享 這觀點以前沒有想過 會再想想的01/03 12:29
15F：→ joejoe14758: 謝謝01/03 12:29
16F：→ joejoe14758: 感覺上層不push這件事 那這件事情就不會有改善的機會01/03 12:30
17F：→ joejoe14758: 了01/03 12:30
18F：噓 alihue: 剛好我公司不追人進度欸01/03 12:33
19F：→ alihue: 公司01/03 12:34
20F：→ alihue: 自己待的公司扭曲成這樣別認為其他公司都這樣搞，多出去01/03 12:35
21F：→ alihue: 別間公司看看吧01/03 12:35
22F：→ alihue: 我在台北待的公司01/03 12:36
23F：→ alihue: 也都沒在看績效和催進度謝謝01/03 12:36
24F：→ alihue: 同事們都在自動自發工作，誰在跟你凹人01/03 12:38
你才多去別家公司看看咧，懶的理你
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:40:44
25F：→ samuel1988: 喔 廢文 01/03 12:53
26F：→ samuel1988: 你不寫文件怎麼整理架構和系統設計 01/03 12:53
27F：→ samuel1988: 一輩子碼農典範 01/03 12:54
28F：→ samuel1988: 你沒有文件怎麼溝通？你到底在哪家公司可以講一講 01/03 12:54
29F：推 layan: 中肯 01/03 13:02
30F：→ samuel1988: 你技術到頂能幫助團隊往前嗎 01/03 13:04
31F：推 yamakazi: 還好我們公司算績效可以拿文件來抵，一堆人尤其主管不寫 01/03 14:23
32F：→ yamakazi: 扣只寫文件 01/03 14:23
33F：推 yamakazi: 如果跟日商公司合作過，你會發現日商特愛寫文件 01/03 14:30
34F：→ yamakazi: 什麼8D, 5 why,好像都是toyota搞出來的那一套。有發現bu 01/03 14:32
35F：→ yamakazi: g後都會叫你寫檢討報告 01/03 14:32
36F：→ yamakazi: 發哥也會叫人寫PDCA 01/03 14:33
37F：噓 as30385438: 同意自己待的公司扭曲別以為大家都這樣，我公司寫文 01/03 14:45
38F：→ as30385438: 件就是開ticket列入正式工作，這不做就是讓專案慢性 01/03 14:45
39F：→ as30385438: 死亡而已 01/03 14:45
40F：→ t64141: 環境對寫文件是否友善是一回事，歸納成文件無用/有害就很 01/03 14:48
41F：→ t64141: 奇怪了 01/03 14:48
42F：→ t64141: 寫文件的過程是需要思考的，會有更多機會重新檢視設計是 01/03 14:53
43F：→ t64141: 否恰當，後人看了也比較能知道當下這樣設計的原因，有機 01/03 14:53
44F：→ t64141: 會避免不清楚歷史背景而改錯 01/03 14:53
45F：→ t64141: 且依你這論點，真遇到所謂九成九以外的公司可能也進不去 01/03 15:01
46F：→ t64141: ，而且你可能不會知道原因，接著繼續歸納出九成九公司不 01/03 15:01
47F：→ t64141: 重視文件... 01/03 15:01
48F：噓 CureYou: 好嗆 01/03 19:27
49F：→ dream1124: 推t64141 而且寫文件不計入工時的話應該向上反應才對吧 01/03 20:34
50F：→ dream1124: 哪有人上班有工作不算工時，叫你想辦法生時間做的 01/03 20:35
51F：噓 cokellen: .... 01/03 20:47
52F：→ jack0204: 所以你認為產糞code才是工作對不對 01/03 21:25
53F：→ airtsubasa: 原文很貼近職場啊，在台某假日商就是這種狀況，又很愛 01/03 21:37
54F：→ airtsubasa: 輪調，無基礎程式能力的人接專案改程式 01/03 21:37
55F：噓 MoonCode: 01/03 22:00
56F：→ sayya2311: 不需有文件時就不用文件啊,你看滿天的open source有完 01/03 22:51
57F：→ sayya2311: 整文件的了了無幾, 有文件前先問為什麼需要文件吧.. 01/03 22:51
58F：→ alihue: 文件是對程式一個很好的 overview，先有概念再 trace 01/03 23:17
59F：→ alihue: code 會好上手很多。更別說有些是含有特地領域的知識，這 01/03 23:17
60F：→ alihue: 時若沒文件，給你 debug mode 下斷點你還是不知道為什麼 01/03 23:17
61F：→ alihue: 要這樣 01/03 23:17
62F：推 kingofsdtw: 代表系統還不夠大吧 01/03 23:52
63F：推 hellomotogg: 血尿推推 01/04 02:15
64F：噓 sorryla: Google要升Senior有很大一部分的評比就是寫文件 01/04 13:29
65F：→ airtsubasa: 可是你不在google阿！ 01/04 18:43
66F：→ viper9709: 不是這樣吧~沒寫文件以後回來連自己都看不懂 01/05 00:16
67F：→ sorryla: 樓樓上，我之前在Google 01/05 02:40
68F：→ alihue: 樓上 XD 01/05 09:16
69F：推 airtsubasa: 那很好啊！不過發文者在鬼島吧 01/05 13:00
70F：推 ms0443001: 鬼島資訊日常 02/03 21:22
71F：噓 Raymond0710: 歪風討噓 02/18 02:43