作者ftrain ()
看板Soft_Job
標題Re: [請益] 第一次被炒魷魚
時間Sun Oct 1 12:48:16 2017
爭吵文件是相當沒意義的事情，
現實情況就是不會有文件，就算有，內容也跟最新的系統兜不上。
如果真的有一份詳細的系統文件，我相信那間公司不是快倒了，
就是根本沒生意，讓聘請來的工程師有那麼多時間去寫詳細的文件。
最後那些要文件的，捫心自問，自己當初留下多少精美的文件
給前一個公司？
不要吵文件的問題了，這種問題只有junior才會有的想法，
senior碰多了，第一時間是看有沒有文件，第二時間確認
文件吻不吻合目前系統，沒有，鼻子摸著快點去看CODE了，
不可能一直陷於「我是被整了嗎？沒文件我怎麼搞？」
實際上台灣的軟體公司，工程師互相都不會有詳細規格文件，
別人不會給你，相同的你離職了也不會有這東西給別人。
這東西很花時間，面對層出不窮一直變化的系統，有這東西的，
我會覺得很怪。
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 36.233.15.120
※ 文章網址: https://webptt.com/m.aspx?n=bbs/Soft_Job/M.1506833299.A.6E9.html
※ 編輯: ftrain (36.233.15.120), 10/01/2017 12:48:49
1F：推 g001613001: 我第一間公司試每個功能開出來，都有給規格書。 我離 10/01 12:50
2F：→ dreamnook: 我每間公司離開前都留完整文件 他們還都很開心 虧了 10/01 12:50
3F：→ g001613001: 職時，也把程式碼都寫好注解，還有交接錄音教學。 10/01 12:50
4F：→ g001613001: 所以這次遇到這個情況，才知道，原來都沒有規格才是 10/01 12:50
5F：→ g001613001: 正常的。 10/01 12:50
6F：→ dreamnook: 原來我應該只留程式碼讓接手的痛苦才符合senior嗎 10/01 12:51
7F：推 cplusplus426: 1年3個月算senior? 10/01 12:51
8F：推 felixgugu: 實情就是如此，我進公司快一年接2個案子也是完全沒文件 10/01 12:53
9F：推 g001613001: 他們公司職務應徵沒有寫要求senior喔，只說一年以上 10/01 12:54
10F：→ felixgugu: 為了錢就默默吃下來了... 10/01 12:54
11F：推 evil2004: 說真的 沒時間可以搞文件 我們PM一直想推 但苦苦找不到 10/01 12:54
12F：→ dreamnook: 不 我是6年的junior xD 10/01 12:54
13F：推 senjor: 沒有文件，那寫的是self-explanatory code嗎？還是有PP？ 10/01 12:54
14F：→ evil2004: 一個適合大家的作法 10/01 12:54
15F：→ senjor: 如果都沒有，那要別人看懂，至少花一個月應該是合理的... 10/01 12:55
16F：→ felixgugu: 問題單就解不完了...誰有空跟你寫文件 10/01 12:55
17F：→ dreamnook: 我接也常常沒文件可以看 但仍覺的留文件較好xD 10/01 12:56
18F：推 g001613001: 我之前公司是給基礎的畫面layout，要使用的API url 以 10/01 12:57
19F：→ g001613001: 及 會get到什麼值，這個值是用在哪個地方，這樣子 10/01 12:57
20F：→ g001613001: 所以開發下來幾乎沒遇到什麼大問題。 10/01 12:57
21F：推 cokellen: 你應該沒待過需要走iso認證的公司，確實有可能寫文件時 10/01 12:59
22F：→ cokellen: 間多於寫code 10/01 12:59
23F：推 vi000246: 程式碼寫得好根本不用文件 10/01 13:00
24F：→ cokellen: 這種公司通常是集團規模，沒這麼容易倒 10/01 13:01
25F：推 StarRoad: 真多工程師把"常態"跟"正確"搞混了吧，我前公司也沒文件 10/01 13:10
26F：→ StarRoad: ，但我一點也不覺得沒文件才是正常的 10/01 13:11
27F：推 TAKADO: 交接/支援時能拿到excel列出功能/參數清單我就覺得祖上積 10/01 13:16
28F：→ TAKADO: 德了，程式稍微註解區塊是最低限。多人協作真的是有點規 10/01 13:16
29F：→ TAKADO: 模的公司要下功夫的地方，不然問題累積起來哪天爆炸都不 10/01 13:16
30F：→ TAKADO: 知道 10/01 13:16
31F：推 ku72: 遇到的都沒文件+1 沒遇到什麼問題也+1 10/01 13:17
32F：推 evil2004: 祖上積德XDDD 我是覺得文件該有 但真的沒時間搞 10/01 13:18
33F：→ ku72: 遇到的註解只有非正常邏輯跟會有誤會處有寫 10/01 13:18
34F：→ dreamnook: 好吧我只是常常積積陰陰德(誤 10/01 13:20
35F：推 a47135: 常態和應不應該搞不清 10/01 13:32
36F：推 YahooTaiwan: 沒文件+1，程式碼就是文件 10/01 14:24
37F：→ YahooTaiwan: senior 本來就該能自己 K 完程式碼 10/01 14:25
38F：→ Argos: 程式寫得好根本不用文件沒錯阿 但問題是程式就寫不好嘛 XDD 10/01 14:32
39F：→ Argos: 當你看到沒有註解 三四個超大類別寫在同一支檔案 10/01 14:33
40F：→ Argos: 一個method上千行 三層以上的巢狀 然後要你幾天內K完 10/01 14:34
41F：→ Argos: 我是覺得不要強人所難 爛code就是爛code 要整理就要花時間 10/01 14:36
42F：推 StarRoad: 程式能取代文件的前提是"寫得好"跟"寫得對"吧。 10/01 15:02
43F：→ StarRoad: 要是功能與規格不合，最好是光看code看的出來。何況有好 10/01 15:03
44F：→ StarRoad: 文件能增加看code的速度，你不給文件就要有花時間的預期 10/01 15:04
45F：→ fidelity77: 沒文件可接受，至但少要給足夠時間看code 吧，兩個禮 10/01 15:06
46F：→ fidelity77: 拜就能 幫忙除bug還覺得人家程度不足？ 10/01 15:06
47F：推 atpx: 金融業購重視規格書了, 還是經常碰上spec老舊問題 10/01 15:06
48F：推 g001613001: 是的，我接到的就是所有的程式碼寫在一個類別裡面的。 10/01 15:10
49F：噓 jennya: 除了第五段 OK 以外，其他段根本都錯誤觀念，竟然沒人噓？ 10/01 17:16
50F：→ jennya: = = 乖乖寫文件的還要被你嗆時間太多沒生意喔，那怎麼不 10/01 17:16
51F：→ jennya: 乾脆嗆有做 refactor 和 code review 的也都是沒生意的公 10/01 17:16
52F：→ jennya: 司？XD 10/01 17:16
53F：噓 jennya: 回應你第四段「自己當初留下多少精美的文件給前公司」，我 10/01 17:24
54F：→ jennya: 就留下好幾份欸，然後前陣子聽說他們還在用欸 (我自己都忘 10/01 17:24
55F：→ jennya: 記我有寫了) 10/01 17:24
56F：→ jennya: 第六段「相同的你離職了也不會有這東西給別人」，不要自己 10/01 17:25
57F：→ jennya: 沒有就以為其他人都不會有 10/01 17:25
58F：→ jennya: 第七段「面對層出不窮一種變化的系統，有這東西的我會覺得 10/01 17:27
59F：→ jennya: 很怪」難道系統是動不動整個大架構都會狂變化？總會有已經 10/01 17:27
60F：→ jennya: 固定不再變的吧，大架構、某些大部分的主要功能、常用常修 10/01 17:27
61F：→ jennya: 改的部分在哪，這些東西就是可以寫進文件的啊。 10/01 17:27
62F：→ jennya: 我的噓文沒有要針對你個人、也不是因為這次事件，單純覺得 10/01 17:28
63F：→ jennya: 這樣的觀念在soft_job版有17推，無法接受。 10/01 17:28
64F：→ LeiaRolando: 遇過沒文件而且變數宣告還是abc 看到就想從16樓往下 10/01 17:33
65F：→ LeiaRolando: 跳 10/01 17:33
66F：→ LeiaRolando: 最後還是靠佛心db才看懂... 10/01 17:34
67F：噓 balius: 台灣就是這一樣，把不正常當成正常然後指責要求回歸正常化 10/01 17:42
68F：→ balius: 的人... 10/01 17:42
69F：推 expup: 中小企業普遍沒文件是真的 但是其他大公司就多少會有 10/01 17:57
70F：→ maxqq: 我身為一個工程師，相當不認同您所講的文件問題 10/01 18:39
71F：→ maxqq: 曾經有一位前輩說，寫文件就代表你的思路夠不夠格 10/01 18:40
72F：→ maxqq: 連寫文件都不寫，這是哪一招？應該是學徒吧 10/01 18:40
73F：→ oread168: 真沒時間最好也要捏著蛋蛋寫個註解.. 10/01 18:53
74F：→ oread168: 任何有用的線索都很珍貴QQ 10/01 18:54
75F：推 SansWord: 這樣看來敝公司快倒了。 10/01 18:58
76F：→ TAKADO: 有時候寫文件是幫自己忙 以未來的自己跟公司同事看 10/01 21:13
77F：→ TAKADO: 不然別說五年 有時候兩年前自己寫的code自己都看不懂了 10/01 21:13
78F：→ hidog: 沒文件沒註解,又一堆work around的code是很恐怖的... 10/01 21:16
79F：噓 wildli0422: 你是我公司的嗎 10/01 21:21
80F：噓 NTULioner: 別把自己呆過的爛公司當作業界常態 10/01 23:24
81F：→ NTULioner: 幾萬行的code沒有文件說明 你要新人兩個星期看懂修完bu 10/01 23:25
82F：→ NTULioner: 這月薪應該可以領100萬 10/01 23:26
83F：噓 DukeLiu: 常態跟應不應該要分清楚 10/02 00:43
84F：→ bndan: 健康的環境會有跟文件等值類似的東西 = = 如果有GIT那理論 10/02 03:20
85F：→ bndan: 上總會有個問題系統吧? 這不要亂寫的話 就跟文件等值了阿.. 10/02 03:22
86F：→ ssccg: 文件並不是一定要長的像SDLC裡面定義的那些才是文件 10/02 04:00
87F：→ ssccg: 程式寫再好，還是會有只看程式邏輯看不出來的業務規則啊 10/02 04:01
88F：噓 doranako: 承包沒規格文件？到時候如何釐清責任 10/02 08:36
89F：噓 FantasyRyu: 別把你待過的爛公司拿出來當常態 10/02 08:51
90F：噓 dobeqoo: 夠大間的公司都有規格書的 10/02 10:03
91F：→ y331752001: 文件管理還是很重要的 10/02 10:35
92F：→ y331752001: 沒有基本文件 以後出問題 完全不知來龍去脈 只是每個 10/02 10:36
93F：→ y331752001: 人有他自己寫法 10/02 10:36
94F：噓 heerowei0802: 真遺憾，在前公司開發兩個案子都有寫文件 給噓 10/02 14:02
95F：噓 arethusa99: 你還是下去吧 正確跟常態都搞不清楚 10/02 21:50
96F：噓 ppz1234: 為奴性哭哭 10/03 09:12
97F：→ leolarrel: 沒文件+1 , 不管是不是正常,在台灣就是如此,有文件的 10/03 09:44
98F：→ leolarrel: 算好運,有制度.不過現在流行敏捷,clean code , 要留文 10/03 09:44
99F：→ leolarrel: 見我看是越來越難了 10/03 09:44
100F：推 senjor: clean code是假的，沒做文件才是真的 Q_Q 10/03 10:26
101F：→ kikiqqp: 原來以前乖乖寫規格書和改版註解並非業界常態呀 10/03 10:49
102F：→ kikiqqp: 平行世界業界？！ 10/03 10:49
103F：噓 a2975313: 寫文件=公司快倒? 別把忙、沒時間、麻煩當作合理好嗎? 10/03 11:35
104F：→ a2975313: 台灣寫code一流 寫文件不入流 10/03 11:37
105F：→ senjor: 有時間上PTT，沒時間寫文件~ 10/03 12:07
106F：噓 justin761002: 噓：把錯誤觀念合理化 10/04 10:19
107F：推 crazwade: 就是習慣不好啊 從小就要養成註解的好習慣 10/05 00:35
108F：噓 seaping: 別把不入流的狀態當常態 10/10 13:35
109F：推 voswo: 不願意做、沒時間做不代表不用做好嗎！ 10/16 20:25
110F：噓 ggttoo: 聽你在屁，我家就小公司沒文件很亂，客戶大公司就有文件.. 10/25 02:01