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

看板Soft_Job (軟體人)作者 (PeterChou)時間5年前 (2021/01/03 01:38), 5年前編輯推噓7(14748)
留言69則, 27人參與, 5年前最新討論串1/1
※ 引述《joejoe14758 (噓文也可以很溫柔)》之銘言 : 原標題:如何維護商業邏輯 : ------------------------------------------ : 大家好 : 最近碰到的情況覺得很麻煩 : 像是常常PM不知道某段的商業邏輯是什麼 : 就來問我 常常我也不知道/忘記了 只能去翻翻code : 因為頻率蠻高的 有時候覺得自己是客服 : 我知道商業邏輯應該要寫在規劃書/規格上 : 但實際狀況可能時間太趕或種種原因導致沒有被記錄到/不完整 : 想請問大家都是怎麼避免/改善這個情況的呢 謝謝 先說結論:不需要補救,管他去死 文件這種東西就是不計入績效, 最多成為點綴 KPI 的東西 寫一份好的技術文件就像概論教科書 讀者看了舒服 爽 但寫作者花了許多精力時間 回報趨近於零 有那個閒工夫不如多鑽研技術 多開發功能 愈是高階、薪水愈高的開發者 愈會跟你說技術文件開發文件很重要 但寫作的永遠不是他 他要花費時間提升自己 認真寫文件的你不知不覺就因為浪費時間 在專業道路上遠遠落後 一種人例外 就是專門嘴炮指導架構的管理者 他們不是專業的軟體架構師 領著豐厚的薪水 產出華麗的文件 卻常常讓實作者覺得有病 所以 聰明的開發者請多為自己的人生想想 如果你不是擁有大量技術股 請不要浪費生命寫文件為人作嫁了 要爛 一起爛 -- ※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 36.225.184.172 (臺灣) ※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1609609128.A.97F.html

01/03 08:13, 5年前 , 1F
中肯,感同身受,但我醒得太晚,人生已經廢了
01/03 08:13, 1F

01/03 09:28, 5年前 , 2F
金融業還會有人靠腰你寫錯字 字體弄錯 頁數沒有refresh
01/03 09:28, 2F

01/03 09:28, 5年前 , 3F
幹 我就不相信稽核會來查核這些毛
01/03 09:28, 3F

01/03 10:48, 5年前 , 4F
中肯
01/03 10:48, 4F

01/03 11:00, 5年前 , 5F
命名做好註解寫重點,沒文件至少不會太慘
01/03 11:00, 5F

01/03 11:01, 5年前 , 6F
如果你所謂的專業道路只侷限於技術開發,自然不會重視
01/03 11:01, 6F

01/03 11:10, 5年前 , 7F
國內認為的專業就是技術開發阿,對於軟體工程的方法論
01/03 11:10, 7F

01/03 11:10, 5年前 , 8F
當然就顆顆
01/03 11:10, 8F

01/03 11:43, 5年前 , 9F
不去補文件,只是挖洞給後人或一段時間後的自己而已
01/03 11:43, 9F

01/03 12:02, 5年前 , 10F
歪理
01/03 12:02, 10F
歪理?花錢啊!哪個公司不追人進度讓人好好處理精美文件算績效的,還是你就是那種拗人 ※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:19:17 大公司小公司九成九要你自己 trace code 啦 ※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:20:56

01/03 12:26, 5年前 , 11F
自己私下隨手寫筆記給自己查就好 就不必浪費時間管排
01/03 12:26, 11F

01/03 12:26, 5年前 , 12F
版格式及完整性
01/03 12:26, 12F

01/03 12:27, 5年前 , 13F
稽核好像真的會對喔 我同事上次schema寫錯字被開單了
01/03 12:27, 13F

01/03 12:29, 5年前 , 14F
我是原po 謝謝分享 這觀點以前沒有想過 會再想想的
01/03 12:29, 14F

01/03 12:29, 5年前 , 15F
謝謝
01/03 12:29, 15F

01/03 12:30, 5年前 , 16F
感覺上層不push這件事 那這件事情就不會有改善的機會
01/03 12:30, 16F

01/03 12:30, 5年前 , 17F
01/03 12:30, 17F

01/03 12:33, 5年前 , 18F
剛好我公司不追人進度欸
01/03 12:33, 18F

01/03 12:34, 5年前 , 19F
公司
01/03 12:34, 19F

01/03 12:35, 5年前 , 20F
自己待的公司扭曲成這樣別認為其他公司都這樣搞,多出去
01/03 12:35, 20F

01/03 12:35, 5年前 , 21F
別間公司看看吧
01/03 12:35, 21F

01/03 12:36, 5年前 , 22F
我在台北待的公司
01/03 12:36, 22F

01/03 12:36, 5年前 , 23F
也都沒在看績效和催進度謝謝
01/03 12:36, 23F

01/03 12:38, 5年前 , 24F
同事們都在自動自發工作,誰在跟你凹人
01/03 12:38, 24F
你才多去別家公司看看咧,懶的理你 ※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:40:44

01/03 12:53, 5年前 , 25F
喔 廢文
01/03 12:53, 25F

01/03 12:53, 5年前 , 26F
你不寫文件怎麼整理架構和系統設計
01/03 12:53, 26F

01/03 12:54, 5年前 , 27F
一輩子碼農典範
01/03 12:54, 27F

01/03 12:54, 5年前 , 28F
你沒有文件怎麼溝通?你到底在哪家公司可以講一講
01/03 12:54, 28F

01/03 13:02, 5年前 , 29F
中肯
01/03 13:02, 29F

01/03 13:04, 5年前 , 30F
你技術到頂能幫助團隊往前嗎
01/03 13:04, 30F

01/03 14:23, 5年前 , 31F
還好我們公司算績效可以拿文件來抵,一堆人尤其主管不寫
01/03 14:23, 31F

01/03 14:23, 5年前 , 32F
扣只寫文件
01/03 14:23, 32F

01/03 14:30, 5年前 , 33F
如果跟日商公司合作過,你會發現日商特愛寫文件
01/03 14:30, 33F

01/03 14:32, 5年前 , 34F
什麼8D, 5 why,好像都是toyota搞出來的那一套。有發現bu
01/03 14:32, 34F

01/03 14:32, 5年前 , 35F
g後都會叫你寫檢討報告
01/03 14:32, 35F

01/03 14:33, 5年前 , 36F
發哥也會叫人寫PDCA
01/03 14:33, 36F

01/03 14:45, 5年前 , 37F
同意自己待的公司扭曲別以為大家都這樣,我公司寫文
01/03 14:45, 37F

01/03 14:45, 5年前 , 38F
件就是開ticket列入正式工作,這不做就是讓專案慢性
01/03 14:45, 38F

01/03 14:45, 5年前 , 39F
死亡而已
01/03 14:45, 39F

01/03 14:48, 5年前 , 40F
環境對寫文件是否友善是一回事,歸納成文件無用/有害就很
01/03 14:48, 40F

01/03 14:48, 5年前 , 41F
奇怪了
01/03 14:48, 41F

01/03 14:53, 5年前 , 42F
寫文件的過程是需要思考的,會有更多機會重新檢視設計是
01/03 14:53, 42F

01/03 14:53, 5年前 , 43F
否恰當,後人看了也比較能知道當下這樣設計的原因,有機
01/03 14:53, 43F

01/03 14:53, 5年前 , 44F
會避免不清楚歷史背景而改錯
01/03 14:53, 44F

01/03 15:01, 5年前 , 45F
且依你這論點,真遇到所謂九成九以外的公司可能也進不去
01/03 15:01, 45F

01/03 15:01, 5年前 , 46F
,而且你可能不會知道原因,接著繼續歸納出九成九公司不
01/03 15:01, 46F

01/03 15:01, 5年前 , 47F
重視文件...
01/03 15:01, 47F

01/03 19:27, 5年前 , 48F
好嗆
01/03 19:27, 48F

01/03 20:34, 5年前 , 49F
推t64141 而且寫文件不計入工時的話應該向上反應才對吧
01/03 20:34, 49F

01/03 20:35, 5年前 , 50F
哪有人上班有工作不算工時,叫你想辦法生時間做的
01/03 20:35, 50F

01/03 20:47, 5年前 , 51F
....
01/03 20:47, 51F

01/03 21:25, 5年前 , 52F
所以你認為產糞code才是工作對不對
01/03 21:25, 52F

01/03 21:37, 5年前 , 53F
原文很貼近職場啊,在台某假日商就是這種狀況,又很愛
01/03 21:37, 53F

01/03 21:37, 5年前 , 54F
輪調,無基礎程式能力的人接專案改程式
01/03 21:37, 54F

01/03 22:00, 5年前 , 55F
01/03 22:00, 55F

01/03 22:51, 5年前 , 56F
不需有文件時就不用文件啊,你看滿天的open source有完
01/03 22:51, 56F

01/03 22:51, 5年前 , 57F
整文件的了了無幾, 有文件前先問為什麼需要文件吧..
01/03 22:51, 57F

01/03 23:17, 5年前 , 58F
文件是對程式一個很好的 overview,先有概念再 trace
01/03 23:17, 58F

01/03 23:17, 5年前 , 59F
code 會好上手很多。更別說有些是含有特地領域的知識,這
01/03 23:17, 59F

01/03 23:17, 5年前 , 60F
時若沒文件,給你 debug mode 下斷點你還是不知道為什麼
01/03 23:17, 60F

01/03 23:17, 5年前 , 61F
要這樣
01/03 23:17, 61F

01/03 23:52, 5年前 , 62F
代表系統還不夠大吧
01/03 23:52, 62F

01/04 02:15, 5年前 , 63F
血尿推推
01/04 02:15, 63F

01/04 13:29, 5年前 , 64F
Google要升Senior有很大一部分的評比就是寫文件
01/04 13:29, 64F

01/04 18:43, 5年前 , 65F
可是你不在google阿!
01/04 18:43, 65F

01/05 00:16, 5年前 , 66F
不是這樣吧~沒寫文件以後回來連自己都看不懂
01/05 00:16, 66F

01/05 02:40, 5年前 , 67F
樓樓上,我之前在Google
01/05 02:40, 67F

01/05 09:16, 5年前 , 68F
樓上 XD
01/05 09:16, 68F

01/05 13:00, 5年前 , 69F
那很好啊!不過發文者在鬼島吧
01/05 13:00, 69F
文章代碼(AID): #1VyA-eb_ (Soft_Job)
文章代碼(AID): #1VyA-eb_ (Soft_Job)