在項目開發過程中,應該按要求編寫好十三種文檔,文檔編制要求具有針對性、精确性、清晰性、完整性、靈活性、可追溯性。
◇可行性分析報告:說明該軟體開發項目的實作在技術上、經濟上和社會因素上的可行性,評述為了合理地達到開發目标可供選擇的各種可能實施方案,說明并論證所標明實施方案的理由。
◇項目開發計劃:為軟體項目實施方案制訂出具體計劃,應該包括各部分工作的負責人員、開發的進度、開發經費的預算、所需的硬體及軟體資源等。
◇軟體需求說明書(軟體規格說明書):對所開發軟體的功能、性能、使用者界面及運作環境等作出詳細的說明。它是在使用者與開發人員雙方對軟體需求取得共同了解并達成協定的條件下編寫的,也是實施開發工作的基礎。該說明書應給出資料邏輯和資料采集的各項要求,為生成和維護系統資料檔案做好準備。
◇概要設計說明書:該說明書是概要實際階段的工作成果,它應說明功能配置設定、子產品劃分、程式的總體結構、輸入輸出以及接口設計、運作設計、資料結構設計和出錯處理設計等,為詳細設計提供基礎。
◇詳細設計說明書:着重描述每一子產品是怎樣實作的,包括實作算法、邏輯流程等。
◇使用者操作手冊:本手冊較長的描述軟體的功能、性能和使用者界面,使使用者對如何使用該軟體得到具體的了解,為操作人員提供該軟體各種運作情況的有關知識,特别是操作方法的具體細節。
◇測試計劃:為做好內建測試和驗收測試,需為如何組織測試制訂實施計劃。計劃應包括測試的内容、進度、條件、人員、測試用例的選取原則、測試結果允許的偏差範圍等。
◇測試分析報告:測試工作完成以後,應送出測試計劃執行情況的說明,對測試結果加以分析,并提出測試的結論意見。
◇開發進度月報:該月報系軟體人員按月向管理部門送出的項目進展情況報告,報告應包括進度計劃與實際執行情況的比較、階段成果、遇到的問題和解決的辦法以及下個月的打算等。
◇項目開發總結報告:軟體項目開發完成以後,應與項目實施計劃對照,總結實際執行的情況,如進度、成果、資源利用、成本和投入的人力,此外,還需對開發工作做出評價,總結出經驗和教訓。
◇軟體維護手冊:主要包括軟體系統說明、程式子產品說明、操作環境、支援軟體的說明、維護過程的說明,便于軟體的維護。
◇軟體問題報告:指出軟體問題的登記情況,如日期、發現人、狀态、問題所屬子產品等,為軟體修改提供準備文檔。
◇軟體修改報告:軟體産品投入運作以後,發現了需對其進行修正、更改等問題,應将存在的問題、修改的考慮以及修改的影響作出詳細的描述,送出審批。