PTT評價

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

看板Soft_Job標題Re: [討論] 如何補救文件不完整專案作者
JasperChang
(PeterChou)
時間推噓 7 推:15 噓:8 →:48

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

先說結論:不需要補救,管他去死

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

最多成為點綴 KPI 的東西

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

讀者看了舒服 爽

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

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

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

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

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

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

在專業道路上遠遠落後

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

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

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

卻常常讓實作者覺得有病

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

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

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

要爛 一起爛


--

※ PTT 留言評論
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 36.225.184.172 (臺灣)
PTT 網址

wintersxp01/03 08:13中肯,感同身受,但我醒得太晚,人生已經廢了

jej01/03 09:28金融業還會有人靠腰你寫錯字 字體弄錯 頁數沒有refresh

jej01/03 09:28幹 我就不相信稽核會來查核這些毛

Nitricacid01/03 10:48中肯

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

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

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

OriginStar01/03 11:10當然就顆顆

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

alihue01/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

csieflyman01/03 12:26自己私下隨手寫筆記給自己查就好 就不必浪費時間管排

csieflyman01/03 12:26版格式及完整性

hanshsu01/03 12:27稽核好像真的會對喔 我同事上次schema寫錯字被開單了

joejoe1475801/03 12:29我是原po 謝謝分享 這觀點以前沒有想過 會再想想的

joejoe1475801/03 12:29謝謝

joejoe1475801/03 12:30感覺上層不push這件事 那這件事情就不會有改善的機會

joejoe1475801/03 12:30

alihue01/03 12:33剛好我公司不追人進度欸

alihue01/03 12:34公司

alihue01/03 12:35自己待的公司扭曲成這樣別認為其他公司都這樣搞,多出去

alihue01/03 12:35別間公司看看吧

alihue01/03 12:36我在台北待的公司

alihue01/03 12:36也都沒在看績效和催進度謝謝

alihue01/03 12:38同事們都在自動自發工作,誰在跟你凹人

你才多去別家公司看看咧,懶的理你

※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:40:44

samuel198801/03 12:53喔 廢文

samuel198801/03 12:53你不寫文件怎麼整理架構和系統設計

samuel198801/03 12:54一輩子碼農典範

samuel198801/03 12:54你沒有文件怎麼溝通?你到底在哪家公司可以講一講

layan01/03 13:02中肯

samuel198801/03 13:04你技術到頂能幫助團隊往前嗎

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

yamakazi01/03 14:23扣只寫文件

yamakazi01/03 14:30如果跟日商公司合作過,你會發現日商特愛寫文件

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

yamakazi01/03 14:32g後都會叫你寫檢討報告

yamakazi01/03 14:33發哥也會叫人寫PDCA

as3038543801/03 14:45同意自己待的公司扭曲別以為大家都這樣,我公司寫文

as3038543801/03 14:45件就是開ticket列入正式工作,這不做就是讓專案慢性

as3038543801/03 14:45死亡而已

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

t6414101/03 14:48奇怪了

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

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

t6414101/03 14:53會避免不清楚歷史背景而改錯

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

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

t6414101/03 15:01重視文件...

CureYou01/03 19:27好嗆

dream112401/03 20:34推t64141 而且寫文件不計入工時的話應該向上反應才對吧

dream112401/03 20:35哪有人上班有工作不算工時,叫你想辦法生時間做的

cokellen01/03 20:47....

jack020401/03 21:25所以你認為產糞code才是工作對不對

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

airtsubasa01/03 21:37輪調,無基礎程式能力的人接專案改程式

MoonCode01/03 22:00

sayya231101/03 22:51不需有文件時就不用文件啊,你看滿天的open source有完

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

alihue01/03 23:17文件是對程式一個很好的 overview,先有概念再 trace

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

alihue01/03 23:17時若沒文件,給你 debug mode 下斷點你還是不知道為什麼

alihue01/03 23:17要這樣

kingofsdtw01/03 23:52代表系統還不夠大吧

hellomotogg01/04 02:15血尿推推

sorryla01/04 13:29Google要升Senior有很大一部分的評比就是寫文件

airtsubasa01/04 18:43可是你不在google阿!

viper970901/05 00:16不是這樣吧~沒寫文件以後回來連自己都看不懂

sorryla01/05 02:40樓樓上,我之前在Google

alihue01/05 09:16樓上 XD

airtsubasa01/05 13:00那很好啊!不過發文者在鬼島吧

ms044300102/03 21:22鬼島資訊日常

Raymond071002/18 02:43歪風討噓