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