2007年11月6日 星期二

G03 文件是必要之惡?

開發系統的人幾乎都覺得寫文件是很痛苦的事,但是一些理論與公司規定卻又要求非寫出哪些文件不可,只好心不甘情不願的花時間敷衍了事。以前的我也抱著同樣的心態,但是在領悟應把心裡的想法留下記錄的道理後,就變得十分支持依系統開發的各個階段產出應有的文件。

設計人員通常會把瞭解需求之後的構思直接轉換為實作的程式碼,這對寫作的人來說是自然不過的事;系統的需求、需求如何轉實作、實作時的邏輯、物件的對應與使用等等很多的細節都是在他腦海裡的產物,當你拿到的只是開始的需求資料與結果的程式碼,要多少時間才能找出其間的演變關係?

順向依各個階段把心裡想法記錄下來是我現今堅持的理念,即使專案沒有足夠的時間,我也會依循文章裡提到的原則簡短地記錄。當文件成為想法一步步實現時的腳印後,就不需要做完系統才寫回憶錄而且寫了還完全沒用的痛苦,因為裡面寫的都是形成系統的重要概念與想法。

接下來就依系統各個階段的演進來看看應該會產生出什麼樣的文件與其代表的意義。

沒有留言:

張貼留言