牛腩新聞發佈系統——文檔是前進的指明燈

      之前在學習軟件工程的時,在沒有項目經驗的前提下進行文檔設計,聽的是糊里糊塗,在做了【機房收費系統】之後再次進行文檔設計,因爲只是個人開發,只是爲了實現而實現,對於文檔的重要性沒有很深的體會,現在到了【新聞發佈系統】完成了三分之二的時候,深刻體會到了軟件開發的前期工作文檔是萬萬不能少的。

      技術、周邊組織機構、行業傳統等若干因素湊在一起,定義了項目必須準備的一些文書工作。對於一個剛從技術人員中任命的項目經理來說,這簡直是一件徹頭徹尾令人生厭的事情,但是如果沒有認識到這些文檔的某些部分包含和表達了一些管理方面的工作,每份文檔的準備工作不是集中考慮,並沒有使各種討論意見明朗化,項目往往會處於無休止的混亂狀態。

      Frederick P. Brooks根據自身的工作經驗在《人月神話》這一本書中也談到了文檔的重要性,可以歸結爲三點:

                  

 


結合高校雲平臺v2.0說明文檔的意義:

1.提高軟件開發的能見度。把開發過程中發生的事件記錄在文檔中,負責人通過這些文檔作爲檢查軟件開發進度和開發質量的依據,實現對軟件開發的工程管理。

2.提高開發效率。文檔驅動型的開發,使得開發人員對於各個階段的開發情況、出現的問題、解決的方法都瞭然於胸,避免在相同的問題上花費過多的時間。可以通過周密思考、整體權衡,從而減少返工。

3.是開發人員在一定階段工作成果和結束的標誌。

4.記錄開發過程的有關信息,便於以後系統的使用和運維,有利於各個版本直接進行交接,給以後相似的軟件開發提供借鑑經驗。

5.便於負責人、開發人員、操作員、測試人員、用戶之間的協作和交流。

對於【牛腩新聞發佈系統】的文檔,儘管是個人開發,但是文檔的書寫依然重要。從編寫設計說明書中對之前所學的SQL語句進一步鞏固,在後期進行前臺設計和後臺開發時,對於文檔中數據庫設計圖、系統功能圖、界面模擬圖以及數據表類操作方法等一直都離不開文檔的指導。

【總結】軟件已從傳統的開發方式發展到工業化的生產方式,文檔在開發的過程中起到了關鍵性作用,它是軟件開發的規範和指明燈,文檔的跟蹤維護是項目監督和預警的機制,其本身可以作爲檢查列表、狀態控制,也可以作爲彙報的數據基礎,應該把文檔看做一個友好的工具,尤其是對於項目經理來說。寫文檔就像寫歷史著作一樣,回顧過去、立足現在、展望未來,記錄下所發生的事情。


 



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章