伊莉討論區

標題: 公司軟體開發沒文件 [打印本頁]

作者: 776556 時間: 2017-5-5 12:10 AM 標題: 公司軟體開發沒文件

公司有erp產品
一般新的客戶軟體需求，都是用舊的軟體拿來改所以沒有任何文件可以看，都是負責人用口頭說明，請問大家工作上也是這樣嗎?

作者: chevylin0802 時間: 2017-5-5 08:55 AM

本帖最後由 chevylin0802 於 2017-5-5 08:58 AM 編輯

你只能說你遇到的公司在研發上不規範
由於有許多小公司接單接到沒有足夠的人力去開發
所以就會產生沒有人做文件的困擾
尤其是幫別的企業做客製化服務的時候最常見到
也因此
有一些公司就變成了負責人以口頭說明的方式
當然我不認為真的搞一堆文件就一定有用
事實上你叫RD天天寫工作日誌也不是不可能
可以自己架一套內部伺服器裏面弄一套BLOG的系統
然後給RD們做工作日誌
至少它比專案時程管理要來得有用

作者: w12463 時間: 2017-5-26 01:46 PM

不只是軟體開發公司連一般中小公司很常見
即使有ERP系統也沒有詳盡的說明文件
就算有也是給外行人看的
內行人想看的偏偏沒寫在上面...

作者: 行過沒碰到 時間: 2017-5-30 10:13 PM

看是那種文檔, 程式碼裡面的備註還好, 其他正式文檔多半是亂寫還是馬馬虎虎的, 錯漏百出, 看了也沒用

作者: chevylin0802 時間: 2017-5-31 12:34 AM

本帖最後由 chevylin0802 於 2017-5-31 12:48 AM 編輯

行過沒碰到發表於 2017-5-30 10:13 PM
看是那種文檔, 程式碼裡面的備註還好, 其他正式文檔多半是亂寫還是馬馬虎虎的, 錯漏百出, 看了也沒用 ...

你還沒看過最扯的，程式碼的註解比程式碼本身還要多。而註解的內容卻是一堆某某工程師在某時間點做了什麼事。連這麼瞎扯蛋的註解都可以比整個程式碼還多，還有什麼事做不出來的？
反而不需要過於著墨於程式碼的註解，因為破壞畫面反而會讓人難以看懂。一般都是只要在函式開頭及物件開頭作說明，特殊的場合也需要短的註解。多重迴圈的終點有必要簡單的提示性註解以外。實在想不出把誰修改的也加入註解的必要性及可靠性。
其實真的應該做的也不是如以前的三圖四冊式的標準文件。文件是夠仔細沒錯，但是花在寫文件的時間比研發的時間還多，就變成沒必要了。更何況根本沒有人有辦法花那麼多時間看文件，最後也只會是封存一途。
最可行的還是工作日誌，因為日誌會交待出做了什麼事，以及思路是什麼。比較一目了然，用blog去架給工程師用就可以。

作者: w12463 時間: 2017-11-25 02:46 PM

頂多只有給外人看的文件內行人想看的一點都沒有...
作文件要花時間老闆又看不到實際產出
會做的人就不想做文件了

作者: MY0613 時間: 2018-6-27 10:35 AM

文件…
以前在大公司真的在軟體工程，它的確很重要。
現在在小公司真的在搞產品，它的重要性遠遠比不上…功能完成通過測試還能趕上市場的時間點。

文件給寫程程（做工）的人看，只是入門快，想問的事想了解的流程邏輯，還是在源碼內…
你追求的是什麼？我會比較傾向有 issue tracking system,
發生的問題/需求/Bug 是什麼？用了什麼想法解決？評估的 side effect 是什麼？
這比"文件"來的重要多了，越有歷史共業的東西，越需要有 issue tracking system 來幫忙…
朝管理的系統方向，對團隊開發才有幫助。

另外源碼軟體的生命週期是一直在前進的，你希望的文件…也是能前進的嗎？
那誰來維護"文件"呢？

歡迎光臨伊莉討論區 (http://a04.eyny.com/)