2007年3月27日 星期二

寫程式當思做文件之苦,作文件當思需求和程式架構正確

最近忙於老師一個OpenSource的計畫,要引入CMMI
計畫已經到達期中階段,要交系統規劃報告書。
而延續上一份系統需求書所往下走,這份規劃書是份量最重的一個
因此讓我喚起大學所學,有感而發,當初也寫了不少文件。
當初在學習的時候,其實完全沒有系統架構的感覺,
因為沒有經驗加上老師批改的嚴厲,時常可能上台被電。
然而這次計畫至少有附帶另一個系統文件來參考,
加上沒有程式撰寫的時程壓力,在我經驗的累積下
現在寫起來確實比之前得心應手。

我忘了原來以前文件都是同學寫的,我都是在coding喔。冏

這次計畫剛好又是種反向工程,其實以前學長程式寫完了,我們把他文件化而已
不過卻發現為了畫比較好看的系統架構描述和分層架構,反而增加了原本程式原本沒有寫的地方。
這不是新增加使用者的功能,卻是開發者程式撰寫時應該需要劃分的架構。
也算是把他變得有介面架構一點的結果吧。相對而言類別多了一些。
基本上還是要有一點MVC的感覺。就只是有分一些子系統和模組了。

這次有仔細描述的文件,應該不至於被評審批改的太兇。
當然姑且不論需求規劃是不是寫的正確的。文件對應程式的正確性應該不差。
其他是編號和需求規劃描述的地方,只盼同學修改回上一份去了。

沒有留言: