[請益] 強者不需要註解消失

看板Tech_Job作者時間9年前 (2016/07/20 09:34), 9年前編輯推噓62(65375)
留言143則, 91人參與, 最新討論串1/4 (看更多)
大家早, 我轉發了各位在上篇討論的結果給我剛退伍的同學, 小弟先代他謝謝各位的回覆, 但是... 這件事情居然有後續,我也先建議他趕快開履歷重找工作了 他手上那份source code其實 「完全沒有註解」 而且聽說也是架構不明,各種奇怪的coding方式跟變數命名 還有很多跟實際功能搭不上的function名稱 奇怪的coding舉例: int functionX(int data, int Size, int Length) { ... functionY(data,Length,Size) } int functionY(int data, int Size, int Length) { .... } 我光看這段就覺得無言了 code真的很亂的感覺 他說他有問主管為什麼code沒註解也沒有文件 主管說:「強者不需要註解」 -- ※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 49.214.19.219 ※ 文章網址: https://www.ptt.cc/bbs/Tech_Job/M.1468978484.A.B6F.html

07/20 09:39, , 1F
你去其他公司也會遇到一樣的情況 稍微不順利就想走 不是
07/20 09:39, 1F

07/20 09:39, , 2F
一個好的工作態度
07/20 09:39, 2F

07/20 09:51, , 3F
就想辦法看懂,然後思考一下如果自己做是不是可以不要
07/20 09:51, 3F

07/20 09:51, , 4F
樓上肯定不是寫軟體的,如果工作是在寫軟體而公司又如此不重視
07/20 09:51, 4F

07/20 09:51, , 5F
這塊,建議快換
07/20 09:51, 5F

07/20 09:51, , 6F
這樣寫,他主管那個回答就是個射後不理的態度,能不能跟
07/20 09:51, 6F

07/20 09:52, , 7F
就從一些小事的累積上看出來......
07/20 09:52, 7F

07/20 09:54, , 8F
讀懂跟花很多時間讀懂差很多好嗎
07/20 09:54, 8F

07/20 09:57, , 9F
這種code還是快走吧....接下去根本自找麻煩
07/20 09:57, 9F

07/20 10:01, , 10F
其實業界的code,很多是這樣的,同事如果願意教你,比
07/20 10:01, 10F

07/20 10:01, , 11F
自己摸快很多。
07/20 10:01, 11F

07/20 10:05, , 12F
強者也是會寫出垃圾的
07/20 10:05, 12F

07/20 10:12, , 13F
XDDDDDD 直接離職吧
07/20 10:12, 13F

07/20 10:14, , 14F
註解很重要啊!
07/20 10:14, 14F

07/20 10:15, , 15F
應該是之前離職的惡整老闆吧…幾萬行沒註解,function
07/20 10:15, 15F

07/20 10:15, , 16F
功能是用硬背的喔?
07/20 10:15, 16F

07/20 10:22, , 17F
我是都寫架構註解在筆記本上 離職就帶走了...-3-
07/20 10:22, 17F

07/20 10:22, , 18F
code 不是一個人就可以搞定
07/20 10:22, 18F

07/20 10:26, , 19F
強者不需要柱柱姊 需要小英
07/20 10:26, 19F

07/20 10:27, , 20F
^^^^^^^^^^^^^^^^^^^^^^^^^ 只有幾萬行的可以
07/20 10:27, 20F

07/20 10:36, , 21F
不註解,原作者才有存在的價值
07/20 10:36, 21F

07/20 10:36, , 22F
XDDD~~~
07/20 10:36, 22F

07/20 10:43, , 23F
薪水要是足以找到真強者,不如全部重新寫過算了
07/20 10:43, 23F

07/20 10:43, , 24F
與其看一個不一定會動要debug半天重新解讀
07/20 10:43, 24F

07/20 10:44, , 25F
還不如自己再寫一個自己編排完整好維護的版本
07/20 10:44, 25F

07/20 10:45, , 26F
註解的要求可以看出公司的管理態度...
07/20 10:45, 26F

07/20 10:45, , 27F
如果他給的薪水 是給強者的薪水 那就埋頭幹下去啊!
07/20 10:45, 27F

07/20 10:45, , 28F
其實最大的陷阱還不是不會動,而是動錯了你沒發現
07/20 10:45, 28F

07/20 10:46, , 29F
可讀性夠高可以不寫吧
07/20 10:46, 29F

07/20 10:50, , 30F
看錢的多寡
07/20 10:50, 30F

07/20 11:00, , 31F
不是大俠吃香蕉
07/20 11:00, 31F

07/20 11:04, , 32F
癡,不能維護的source才能當一方source閥,不怕失業!
07/20 11:04, 32F

07/20 11:06, , 33F
都嘛可以看懂,但是效率不高,最好有文件
07/20 11:06, 33F

07/20 11:11, , 34F
因為老闆也看不懂,註解錯了被發現就丟臉了
07/20 11:11, 34F

07/20 11:17, , 35F
比亂註解好多惹
07/20 11:17, 35F

07/20 11:24, , 36F
屁啦 最好是主管講話那麼嘴砲
07/20 11:24, 36F

07/20 11:32, , 37F
就嘴回去 說 可是我領的是弱者的薪水
07/20 11:32, 37F

07/20 11:40, , 38F
這種淺度思考的爛code 當然不需要註解....
07/20 11:40, 38F

07/20 11:43, , 39F
主管講話也會中二?
07/20 11:43, 39F
還有 65 則推文
還有 3 段內文
07/20 20:09, , 105F
強者不寫註解原因是可讀性高,很明顯這位根本是嘴砲強
07/20 20:09, 105F

07/20 20:11, , 106F
補充:是 code 本身可讀性就很高
07/20 20:11, 106F

07/20 20:12, , 107F
黨,不需要柱姐
07/20 20:12, 107F

07/20 20:44, , 108F
塊陶吧 就算是自己寫的扣,沒寫註解久了都有可能忘記在
07/20 20:44, 108F

07/20 20:44, , 109F
寫什麼,何況是看別人的,這主管根本沒概念
07/20 20:44, 109F

07/20 20:47, , 110F
天書就是這樣來的
07/20 20:47, 110F

07/20 21:15, , 111F
請問那段code是真的寫"functionX"這樣的function name
07/20 21:15, 111F

07/20 21:16, , 112F
嗎?
07/20 21:16, 112F

07/20 21:56, , 113F
請問讓大家感覺是糟糕code的問題在哪,撇開functionX
07/20 21:56, 113F

07/20 21:56, , 114F
的命名
07/20 21:56, 114F

07/20 22:12, , 115F
白目 快笑死
07/20 22:12, 115F

07/20 22:12, , 116F
還看過 fun_x(a,b,c) { ...; fun_x(a,b,c); ...;}
07/20 22:12, 116F

07/20 22:21, , 117F
強者不都砍掉重練比較快,幹嘛要看
07/20 22:21, 117F

07/20 22:32, , 118F
我猜functionY裡是要 { ...; return functionX(...);}
07/20 22:32, 118F

07/20 22:33, , 119F
也許是額外的需求, 但改動量太低, 這樣改最快.
07/20 22:33, 119F

07/20 22:34, , 120F
像是Windows API 中一大堆 CreateXYZ, CreateXYZ 這樣?
07/20 22:34, 120F

07/20 22:36, , 121F
最難的是讀懂,接著幹.次一級是整段打掉重寫,Debug到順.
07/20 22:36, 121F

07/20 22:37, , 122F
強者的確不太需要註解阿 前提是先寫得像自然語言吧
07/20 22:37, 122F

07/20 22:37, , 123F
再差一級是看不懂,亂罵一通,推給別人,別人還是得接著幹
07/20 22:37, 123F

07/20 22:40, , 124F
如果單純只是c 還真得不太需要註解
07/20 22:40, 124F

07/20 22:42, , 125F
不過這是對寫得人而言 沒接觸過的人就不一定
07/20 22:42, 125F

07/20 22:45, , 126F
至少還有function.....,有一種是沒funciton然後變數x1x2
07/20 22:45, 126F

07/20 22:51, , 127F
一直都會有人拿一份舊code給我, 叫我加個什麼功能.
07/20 22:51, 127F

07/20 22:52, , 128F
沒有一個是好讀懂的,能不做嗎?先build通再想辦法debug
07/20 22:52, 128F

07/20 22:52, , 129F
看懂原作者的想法,再加新的需求上去不影響原來功能.
07/20 22:52, 129F

07/20 22:53, , 130F
大家不都是這樣的嗎.看不滿意順手幫你經過的地方加註解
07/20 22:53, 130F

07/20 22:54, , 131F
不就好了嗎, 這樣以後的人至少經過這邊就看的懂了.
07/20 22:54, 131F

07/20 23:08, , 132F
然後勞心勞力幫人擦屁股還沒有績效
07/20 23:08, 132F

07/20 23:22, , 133F
當然會有,你功力進步,同事也看在眼裡,別只是想著功利
07/20 23:22, 133F

07/21 00:14, , 134F
對後人是種麻煩 快逃啊 這公司 以後這種事一定越來越
07/21 00:14, 134F

07/21 00:14, , 135F
07/21 00:14, 135F

07/21 00:17, , 136F
花時間看懂又沒績效 搞不好你寫得還更好
07/21 00:17, 136F

07/21 08:15, , 137F
真的看不懂時又沒文件,會去看unittest,不過有人連unittest
07/21 08:15, 137F

07/21 08:15, , 138F
都沒有 XD
07/21 08:15, 138F
ggg12345:轉錄至看板 Soft_Job 07/21 20:11

07/21 21:40, , 139F
單從這二段看不出功力,至少看的出大概要傳入什麼~
07/21 21:40, 139F

07/21 21:43, , 140F
到是這樣被嚇到,那功力可能不夠~
07/21 21:43, 140F

07/21 22:27, , 141F
我還遇過變數名稱命名xxx_length,結果想半天想不透,問
07/21 22:27, 141F

07/21 22:27, , 142F
了才知道那東西是徑度...
07/21 22:27, 142F

07/22 17:11, , 143F
真的很好笑 建議轉 joke版
07/22 17:11, 143F
文章代碼(AID): #1NZjKqjl (Tech_Job)
文章代碼(AID): #1NZjKqjl (Tech_Job)