→ alan3100:不論好壞 文件都應該要寫 02/04 23:35
推 CGary:文件應該要寫 只是應該要寫到甚麼程度 現在很多高階語言越來 02/05 02:05
關於這點
其實應該盡量推廣在coding和架構設計的時候,就要讓你的程式是簡潔易懂的
這邊就很吃programmer的功力了
老實說啦,真正會寫好code的人,技術文件寫出來的也是一看就懂
不過根本沒必要寫,因為你看他的code和架構就一清二楚了
相反的,architecture亂七八糟,naming一團亂的
即使叫他寫一份技術文件
他寫了100頁,保證你看完還是模模糊糊,所謂寫文件真的就是寫讓人心安而已
根本的重點是在於SW RD整個coding concept的培養和訓練
而不是在於那種制式化的東西
當然,SW拿的錢高低,從這邊切入其實就很清楚可以看出這個programmer的素質高低
→ CGary:越推崇讓 Code 跟 Plain English 一樣易懂... 所以也不一定 02/05 02:06
→ CGary:要死守常規 不過有一個前提：寫code 的人程度真的要夠好 XD 02/05 02:06
→ metaphysic:這邊觀念正確 我對工程師的要求就是不看文件也要能看懂 02/05 04:21
→ metaphysic:表達能力差的人 寫出來的文件一樣讓人看不懂 02/05 04:21
→ metaphysic:code寫不好的人,寫文件 註解一樣爛到爆. 02/05 04:23
推 mirageX:推這篇 02/05 10:29
--
※ 發信站: 批踢踢實業坊(ptt.cc)
◆ From: 114.43.140.167
※ 編輯: oneheat 來自: 114.43.140.167 (02/05 20:39)
推 LetDogDay:讓程式自己說話是寫文件的最佳境界 02/05 20:57
推 Yaiyu:會拍馬屁就夠了 我旁邊的學姊做了20幾年現在連excel都不太會 02/14 22:03
→ Yaiyu:他有60K up 02/14 22:04
→ metaphysic:樓上旁邊的學姊可能不只會拍馬屁,還會吹簫. 02/17 22:02