Re: [討論] 如何補救文件不完整專案
※ 引述《joejoe14758 (噓文也可以很溫柔)》之銘言
: 原標題：如何維護商業邏輯
: ------------------------------------------
: 大家好
: 最近碰到的情況覺得很麻煩
: 像是常常PM不知道某段的商業邏輯是什麼
: 就來問我 常常我也不知道/忘記了 只能去翻翻code
: 因為頻率蠻高的 有時候覺得自己是客服
: 我知道商業邏輯應該要寫在規劃書/規格上
: 但實際狀況可能時間太趕或種種原因導致沒有被記錄到/不完整
: 想請問大家都是怎麼避免/改善這個情況的呢 謝謝
先說結論：不需要補救，管他去死
文件這種東西就是不計入績效，
最多成為點綴 KPI 的東西
寫一份好的技術文件就像概論教科書
讀者看了舒服 爽
但寫作者花了許多精力時間 回報趨近於零
有那個閒工夫不如多鑽研技術 多開發功能
愈是高階、薪水愈高的開發者
愈會跟你說技術文件開發文件很重要
但寫作的永遠不是他 他要花費時間提升自己
認真寫文件的你不知不覺就因為浪費時間
在專業道路上遠遠落後
一種人例外 就是專門嘴炮指導架構的管理者
他們不是專業的軟體架構師
領著豐厚的薪水 產出華麗的文件
卻常常讓實作者覺得有病
所以 聰明的開發者請多為自己的人生想想
如果你不是擁有大量技術股
請不要浪費生命寫文件為人作嫁了
要爛 一起爛
--
中肯，感同身受，但我醒得太晚，人生已經廢了
金融業還會有人靠腰你寫錯字 字體弄錯 頁數沒有refresh
幹 我就不相信稽核會來查核這些毛
中肯
命名做好註解寫重點，沒文件至少不會太慘
如果你所謂的專業道路只侷限於技術開發，自然不會重視
國內認為的專業就是技術開發阿，對於軟體工程的方法論
當然就顆顆
不去補文件，只是挖洞給後人或一段時間後的自己而已
歪理
歪理？花錢啊！哪個公司不追人進度讓人好好處理精美文件算績效的，還是你就是那種拗人
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:19:17大公司小公司九成九要你自己 trace code 啦
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:20:56自己私下隨手寫筆記給自己查就好 就不必浪費時間管排
版格式及完整性
稽核好像真的會對喔 我同事上次schema寫錯字被開單了
我是原po 謝謝分享 這觀點以前沒有想過 會再想想的
謝謝
感覺上層不push這件事 那這件事情就不會有改善的機會
了
剛好我公司不追人進度欸
公司
自己待的公司扭曲成這樣別認為其他公司都這樣搞，多出去
別間公司看看吧
我在台北待的公司
也都沒在看績效和催進度謝謝
同事們都在自動自發工作，誰在跟你凹人
你才多去別家公司看看咧，懶的理你
※ 編輯: JasperChang (27.246.101.130 臺灣), 01/03/2021 12:40:44喔 廢文
你不寫文件怎麼整理架構和系統設計
一輩子碼農典範
你沒有文件怎麼溝通？你到底在哪家公司可以講一講
中肯
你技術到頂能幫助團隊往前嗎
還好我們公司算績效可以拿文件來抵，一堆人尤其主管不寫
扣只寫文件
如果跟日商公司合作過，你會發現日商特愛寫文件
什麼8D, 5 why,好像都是toyota搞出來的那一套。有發現bu
g後都會叫你寫檢討報告
發哥也會叫人寫PDCA
同意自己待的公司扭曲別以為大家都這樣，我公司寫文
件就是開ticket列入正式工作，這不做就是讓專案慢性
死亡而已
環境對寫文件是否友善是一回事，歸納成文件無用/有害就很
奇怪了
寫文件的過程是需要思考的，會有更多機會重新檢視設計是
否恰當，後人看了也比較能知道當下這樣設計的原因，有機
會避免不清楚歷史背景而改錯
且依你這論點，真遇到所謂九成九以外的公司可能也進不去
，而且你可能不會知道原因，接著繼續歸納出九成九公司不
重視文件...
好嗆
推t64141 而且寫文件不計入工時的話應該向上反應才對吧
哪有人上班有工作不算工時，叫你想辦法生時間做的
....
所以你認為產糞code才是工作對不對
原文很貼近職場啊，在台某假日商就是這種狀況，又很愛
輪調，無基礎程式能力的人接專案改程式
不需有文件時就不用文件啊,你看滿天的open source有完
整文件的了了無幾, 有文件前先問為什麼需要文件吧..
文件是對程式一個很好的 overview，先有概念再 trace
code 會好上手很多。更別說有些是含有特地領域的知識，這
時若沒文件，給你 debug mode 下斷點你還是不知道為什麼
要這樣
代表系統還不夠大吧
血尿推推
Google要升Senior有很大一部分的評比就是寫文件
可是你不在google阿！
不是這樣吧~沒寫文件以後回來連自己都看不懂
樓樓上，我之前在Google
樓上 XD
那很好啊！不過發文者在鬼島吧
鬼島資訊日常
歪風討噓
31
[請益] 大家看好Flutter嗎？軟工版的前輩們大家好 想請問大家用過flutter來開發app&看好這項技術嗎？ 我是最近在公司的交流會中 跟其他同期新進員工聊天得知有這個技術的。 用flutter就能寫android、iOS 跟web app看起來的確很方便。![[請益] 大家看好Flutter嗎？](https://storage.googleapis.com/cms-storage-bucket/70760bf1e88b184bb1bc.png "[請益] 大家看好Flutter嗎？")
28
[請益] 該配置多少人力想請教各位大大一下 一個規模為三百多萬 開發時程兩個月的專案通常會配置多少人力？ 這份工作為小弟第一份軟體工作 資歷差不多一年三個月21
[請益] 找工作請益最近正式離開我的第一份工作 離開理由除了薪資3年只有35K之外 有時開發的新功能有時沒有完整的流程圖跟相關文件 都要由主管口述，這樣開發起來有些沒效率 所以下一份想找45K*14 然後能穩定調薪15
Re: [請益] 如何有效率的看code ?如果你沒寫錯的話 一年多看幾萬行code真的不多 我也是轉職仔，原本在ic house寫C做韌體，一個人負責一個.c/.h檔。一年才進三行code。 轉職後寫C++整個team大約十多人，負責的那一層有兩千萬行code。然後第一年就進快一萬行code。 我原本不會C++的，所以什麼framework，modern C++，design pattern，multithreaded 之類的都沒學過要重學。10
Re: [請益] 當主管要求員工留下獨門經驗的技術文件其實寫這種文件 受惠最大的還是自己啦 為什麼不寫？ 尤其是當你面試下家公司的時候 過去做過哪些project7
Re: [討論] 所謂的開發強者是怎麼樣子的?我以前在漂亮國工作的時候 有遇過一個美國白人大神 CMU畢業的 在IC design公司寫軟體 簡直屌打一票人2
[問卦] 為什麼一堆技術文件像寫給鬼看的一堆技術文件放在官網給人家看， 結果寫的亂七八糟， 到底要人家怎麼用啊， 例如叫你安裝，然後安裝連結放超遠， 找半天，把文件寫的淺顯易懂很難嗎？4
Re: [請益] 非本科Java第一份工作問題（代PO)從來都不用框架、跟框架不熟會有很多問題： 1. 你是站在地上靠自己的身高跟站在巨人肩膀上的在競爭 九成的情況，很多東西是不需要自己開發的，如果善於找方案通常可以很快找到 而一成的情況當你需要自己造輪子的時候，你如果不是已經用過各式各樣的輪子 你發明的輪子肯定很難用1
Re: [請益] 當主管要求資深RD撰寫自己經驗的文件好奇是真的遇過這樣的事情,還是純粹自己想像. 想了一下大概有幾種狀況 1. 如果是公司文化或新的大頭希望公司能加強文件,那就乖乖配合 確實有公司會要求文件寫得很完整. 2. 公司即將資遣你,所以希望先把你的東西挖出來
![[討論] Python取代JavaScript成為GitHub上最受歡](https://s4.itho.me/sites/default/files/field/image/1104-octoverse_2024-github-960.jpg "[討論] Python取代JavaScript成為GitHub上最受歡")
![[心得] 讓 AI 好好說話，兩步提示增強模型輸出](https://i.imgur.com/XJbjNh3b.jpg "[心得] 讓 AI 好好說話，兩步提示增強模型輸出")