在開發專案的過程中,我深刻的意識到,文件存在的意義並不是無用的報告,簡潔明瞭的文件不光能記錄你當下所做的,還能在繁重的工作中分神思考下一步該做什麼時為你節約精力,並且在專案週期內,使整個專案保持一致性。所以,軟體開發文件的編寫是很有必要的。我參考網上的資料,結合自己專案開發時的心得,分享一些經驗。
在專案開發過程中,應該按要求編寫好十三種文件,文件編寫要求具有針對性、精確性、清晰性、完整性、靈活性、可追溯性。同時依照專案人員的角色劃分,完成不同型別的文件。以下排序並未嚴格按照時間排序。
可行性研究報告的編寫目的是:說明該軟體開發專案的實現在技術、經濟和社會條件方面的可行性;評述為了合理達到開發目標而可能選擇的各種方案;實施方案的利弊;說明並論證所選定的方案。
軟體專案開發計畫即為軟體專案實施方案制定出的具體計畫。專案開發計畫應提前給管理部門,並作為開發階段評審的基礎。編寫專案開發計畫的目的是用檔案的形式,把對於在開發過程中各項工作的負責人員、開發進度、所需經費預算、所需的軟硬條件等問題做出的安排記載下來,以便根據本計畫開展和檢查專案的開發工作。
軟體需求說明書也稱為軟體規格說明。該說明書對所開發軟體的功能、效能、使用者介面及執行環境等做出詳細的說明。它是使用者與開發人員雙方對軟體需求取得共同理解基礎上達成的協議,也是實施開發工作的基礎。軟體需求說明書的編寫目的就是為了使使用者和軟體開發者雙方對該軟體的初需求有乙個共同的理解,並使之成為整個開發工作的基礎。
概要設計說明書又可稱系統設計說明書,這裡所說的系統是指程式系統。編寫的目的是說明對程式系統的設計考慮,包括程式系統的基本處理。流程、程式系統的組織結構、模組劃分、功能分配、介面設計。執行設計、資料結構設計和出錯處理設計等,為程式的詳細設計提供基礎。
詳細設計說明書又可稱程式設計說明書。編寫目的是說明乙個軟體系統各個層次中的每乙個程式(每人模組或子程式)的設計考慮。如果專案比較簡單,層次較少,本檔案可以不單獨編寫,有關內容合併入概要設計說明書。
使用者操作手冊的編寫是要使用非專門術語的語言,充分地描述該軟體系統所具有的功能及基本的使用方法,提供該軟體每乙個執行的具體過程和有關知識,包括操作方法的細節。使使用者(或潛在使用者)通過本手冊能夠了解該軟體的用途,並且能夠確定在什麼情況下,如何使用它。
測試計畫是軟體專案實施計畫中的一項重要的內容,應當在軟體開發初期、即需求分析階段制訂。測試計畫應當定義被測試物件和測試目標,確定測試階段和測試週期的劃分;制訂測試人員、軟硬體資源和測試進度等方面的計畫,規定軟體測試方法,測試標準以及支援環境和測試工具。針對子系統在特定的測試階段所要進行的測試工作制訂詳細計畫,它詳細說明規定了測試小組的各項測試任務,測試策略、任務分配和進度安排等。
測試工作完成以後,應當提交測試計畫情況說明書,對測試結果加以分析,並提出測試的結論性意見。
開發進度月報的編寫目的是及時向有關部門匯報專案開發的進度和情況,以便及時發現和處理開發過程**現的問題,一般,開發進度月報是以專案組單位每月編寫的。如果被開發的軟體系統規模比較大,整個工程專案被劃分給若干個分專案駔承擔,開發進度月報將以分專案為單位每月編寫。
軟體專案開發完成之後,應當與專案實施計畫對照,總結實際執行的情況,如進度、成果、資源利用、成本和投入的人力。此外,還需對開發工作做出評價,總結經驗和教訓。專案開發總結報告的編寫是為了總結本專案開發工作的經驗,說明實際取得的開發結果以及對整個開發工作的各個方面的評價。
主要包括軟體系統說明、程式模組說明、操作環境、支援軟體的說明、維護 過程的說明,便於軟體的維護。
指出軟體問題的登記情況,如日期、發現人、狀態、問題所屬模組等,為軟體修改提供準備文件。
軟體產品投入執行以後,發現了需對其進行修正、更改等問題,應將存在的問題、修改的考慮以及修改的影響作出詳細的描述,提交審批。
根據專案的規模大小,以及人員構成,對所需要的文件進行編寫,將大大提高專案開發的效率及規範程度。
專案開發文件編寫規範
在開發專案的過程中,我深刻的意識到,文件存在的意義並不是無用的報告,簡潔明瞭的文件不光能記錄你當下所做的,還能在繁重的工作中分神思考下一步該做什麼時為你節約精力,並且在專案週期內,使整個專案保持一致性。所以,軟體開發文件的編寫是很有必要的。我參考網上的資料,結合自己專案開發時的心得,分享一些經驗。在...
軟體開發文件編寫規範
對於軟體工程學科的同學都知道,軟體工程是一門技術含量高設計極其複雜的學科。為了控制好軟體產品質量和規範,就必須用大量的文件約束軟體工程的進度和狀態。浩大的軟體工程對於缺少工作和專案經驗的人來說,必然是摸不著頭腦不知從何開始。為了讓大家能夠快速適應標準的軟體開發過程,今天我為大家粗略的描述開發中需要的...
編寫乙個專案開發文件
專案開發過程中為了增加程式的可讀性和程式的健壯性,方便後期程式的除錯和維護,所以需要在開發過程中統一技術規範,一般會在專案初期確定好相關文件作為這一統一的規範。不同公司會對文件做不同要求,劃不同的分類,但一般來說 或者拿自己的經驗說 大致可以分為需求文件 介面文件 流程圖 可以單獨作為乙份檔案可以作...