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