【正文】 6）提供對軟件的 運行 、 維護 和 培訓 的有關信息， 便于管理人員、開發(fā)人員、操作人員、用戶之間的協(xié)作、交流和了解 。使軟件開發(fā)活動更科學、更有成效。 （ 7）便于潛在用戶了解軟件的功能、性能等各項指標 ，為他們選購符合自己需要的軟件提供依據(jù)。 從某種意義上來說 ，文檔是軟件開發(fā)規(guī)范的體現(xiàn)和指南。 軟件工程 第十章 軟件質量與質量保證 文檔的分類 （ 1）軟件文檔從形式上來看，大致分為兩類： ? 一類是開發(fā)過程中填寫的各種圖表，稱之為 工作表格 ； ? 一類是應編制的技術資料或技術管理資料，稱之為 文檔或 文件 。 （ 2） 按照文檔產生和使用范圍，軟件文檔大致可分為三類： – 開發(fā)文檔 軟件需求說明書 數(shù)據(jù)要求說明書 概要設計說明書 詳細設計說明書 可行性研究報告 項目開發(fā)計劃 – 管理文檔 項目開發(fā)計劃 測試計劃 測試報告 開發(fā)進度月報 項目開發(fā)總結 – 用戶文檔 用戶手冊 操作手冊 維護修改建議 軟件需求說明書 軟件工程 第十章 軟件質量與質量保證 軟件文檔的工作 國家標準局在 1988年 1月發(fā)布了 《 計算機軟件開發(fā)規(guī)范 》 、 《 軟件產品開發(fā)文件編制指南 》 。作為軟件開發(fā)人員工作的準則和規(guī)程。它們基于軟件生存期的方法，把軟件產品從形成概念開始，經過開發(fā)、使用和不斷增補修訂，直到最后被淘汰的整個過程。 （ 1）可行性研究報告 – 說明該軟件項目的實現(xiàn)在 技術上 、 經濟上 和 社會因素上 的 可行性 。 – 評述為合理地達到開發(fā)目標 可供選擇的 各種可能的實現(xiàn)方案 。 – 說明論證所選定實施方案的理由。 軟件工程 第十章 軟件質量與質量保證 （ 2） 項目開發(fā)計劃 為軟件項目實施方案制定出的具體計劃。它包括 – 各部分工作的負責人員 – 開發(fā)的進度 – 開發(fā)經費的概算 – 所需的硬件和軟件資源等 項目開發(fā)計劃應提供給管理部門，并 作為開發(fā)階段評審的基礎 。 （ 3）軟件需求說明書 對目標軟件的功能、性能、用戶界面及運行環(huán)境等作出詳細的說明。它是用戶與開發(fā)人員雙方對軟件需求取得共同理解基礎上達成的協(xié)議，是實施開發(fā)工作的基礎。 軟件工程 第十章 軟件質量與質量保證 （ 4）數(shù)據(jù)要求說明書 給出數(shù)據(jù)邏輯描述和數(shù)據(jù)采集的各項要求 , 為生成和維護系統(tǒng)的數(shù)據(jù)文件做好準備。 （ 5）概要設計說明書 該說明書是概要設計工作階段的成果。它應當說明 – 系統(tǒng)的功能分配 – 模塊劃分 – 程序的總體結構 – 輸入輸出及接口設計 – 運行設計 – 數(shù)據(jù)結構設計 – 出錯處理設計等 為詳細設計奠定基礎。 軟件工程 第十章 軟件質量與質量保證 （ 6） 詳細設計說明書 著重描述每一個模塊是如何實現(xiàn)的，包括實現(xiàn)算法、邏輯流程等。 （ 7） 用戶手冊 詳細描述軟件的功能、性能和用戶界面，使用戶了解如何使用該軟件。 （ 8） 操作手冊 為操作人員提供軟件各種運行情況有關知識，特別是操作方法細節(jié)。 （ 9）測試計劃 針對組裝測試和確認測試，需要為組織測試制定計劃。計劃應包括： 測試的內容、進度安排、條件、人員、測試用例的選取原則、測試結果允許的偏差范圍等。 軟件工程 第十章 軟件質量與質量保證 （ 10）測試分析報告 測試工作完成后，提交測試計劃執(zhí)行情況的說明。對測試結果加以分析，并提出測試的結論性意見。 （ 11）開發(fā)進度月報 該月報是軟件人員按月向管理部門提交的項目進展情況的報告。報告包括進度計劃與實際執(zhí)行情況比較、階段成果、遇到的問題和解決的辦法以及下個月的打算等。 （ 12）項目開發(fā)總結報告 軟件項目開發(fā)完成之后，應與項目實施計劃對照，總結實際執(zhí)行的情況，如：進度、成果、資源利用、成本和投入的人力。對開發(fā)工作作出評價，總結經驗和教訓。 軟件工程 第十章 軟件質量與質量保證 （ 13） 維護修改建議 軟件產品投入運行之后，可能有修正、更改等問題，應對存在的問題、修改的考慮以及修改的影響估計等做詳細的描述，寫成維護修改建議提交審批。 以上軟件文檔是在軟件生存期中隨著各個階段工作的開展編制的。有的僅反映某一個階段的工作，有的需跨越多個階段。 軟件工程 第十章 軟件質量與質量保證 六、對文檔編制的質量要求 針對性 （ 1） 文檔編制以前 應分清讀者對象 。按照不同的類型、不同層次的讀者，決定怎樣適應他們的需要。 （ 2） 管理文檔主要面向管理人員 （ 3） 用戶文檔主要面向用戶 (2)(3)這兩類文檔不應像開發(fā)文檔 (面向開發(fā)人員 )那樣過多使用軟件的專用術語。 精確性 文檔的行文應當十分確切，不能出現(xiàn)多義性的描述。同一課題幾個文檔的內容應當是協(xié)調一致，沒有矛盾的。 清晰性 文檔編寫應力求簡明，如有可能配以適當?shù)膱D表，以增強其清晰性。 軟件工程 第十章 軟件質量與質量保證 謝謝觀看 /歡迎下載 BY FAITH I MEAN A VISION OF GOOD ONE CHERISHES AND THE ENTHUSIASM THAT PUSHES ONE TO SEEK ITS FULFILLMENT REGARDLESS OF OBSTACLES. BY FAITH I BY FAITH