軟件文檔管理指南ppt課件(已修改)
2025-01-22 05:03 本頁面
【正文】 1 軟件文檔管理指南 (GB/T1668096) 2 簡介 ? 本標準為那些對軟件或基于軟件產品的開發(fā)負有職責的管理者提供軟件文檔的管理指南。目的在于協助管理者在他們的機構中產生有效的文檔。 ? 本標準涉及策略、標準、規(guī)程、資源和計劃，管理者必須關注這些內容，以便有效地管理軟件文檔。 ? 本標準期望應用于各種類型的軟件，從簡單的程序到復雜的軟件系統(tǒng)。并期望覆蓋各種類型的軟件文檔，作用于軟件生存期的各個階段。 3 簡介 ? 不論項目的大小，軟件文檔管理的原則是一致的。對于小項目，可以不采用本標準中規(guī)定的有關細節(jié)。管理者可剪裁這些內容以滿足他們的特殊需要。 ? 本標準是針對文檔編制管理而提出的，不涉及軟件文檔的內容和編排。 4 引用標準 ? GB 856688 計算機軟件開發(fā)規(guī)范 ? GB 856788 計算機軟件產品開發(fā)文件編制指南 ? GB/T 114571995 軟件工程術語 5 定義 ? 文檔 document ?一種數據媒體和其上所記錄的數據。它具有永久性并可以由人或機器閱讀。通常僅用于描述人工可讀的內容。例如，技術文件、設計文件、版本說明文件。 ? 文檔（集） / 文檔編制 documentation ?一個或多個相關文檔的集合。 6 定義 ? 文檔計劃 documentation plan ?一個描述文檔編制工作方法的管理用文檔。 ?該計劃主要描述要編制什么類型的文檔，這些文檔的內容是什么，何時編寫，由誰編寫，如何編寫，以及什么是影響期望結果的可用資源和外界因素。 7 定義 ? 文檔等級 level of documentation ?對所需文檔的一個說明，它指出文檔的范圍、內容、格式及質量，可以根據項目、費用、預期用途、作用范圍或其他因素選擇文檔等級。 ? 軟件產品 software product ?軟件開發(fā)過程的結果，并推出供用戶使用的軟件實體。 8 主要內容 ? 軟件文檔的作用 ? 管理者的作用 ? 制訂文檔編制策略 ? 制訂文檔編制標準和指南 ? 文檔編制計劃 ? 制訂文檔規(guī)程 ? 所需資源 9 軟件文檔的作用 ? 管理依據 ? 質量保證 ? 軟件維護支持 ? 任務之間聯系的憑證 ? 培訓與參考 ? 歷史檔案 10 主要內容 ? 軟件文檔的作用 ? 管理者的作用 ? 制訂文檔編制策略 ? 制訂文檔編制標準和指南 ? 文檔編制計劃 ? 制訂文檔規(guī)程 ? 所需資源 11 管理者的作用 ? 管理者嚴格要求軟件開發(fā)人員和編制組完成文檔編制，并且在策略、標準、規(guī)程、資源分配和編制計劃方面給予支持。 12 管理者對文檔工作的責任 ? 管理者要認識到正式或非正式文檔都是重要的，還要認識到文檔工作必須包括文檔計劃、編寫、修改、形成、分發(fā)和維護等各個方面。 13 管理者對文檔工作的支持 ? 管理者應為編寫文檔的人員提供指導和實際鼓勵，并使各種資源有效地用于文檔開發(fā)。 14 管理者的主要職責 ? 建立編制、登記、出版系統(tǒng)文檔和軟件文檔的各種策略 ? 把文檔計劃作為整個開發(fā)工作的一個組成部分 ? 建立確定文檔質量、測試質量和評審質量各種方法的規(guī)程 ? 為文檔的各個方面確定和準備各種標準和指南 ? 積極支持文檔工作以形成開發(fā)中自覺編制文檔的團隊風氣 ? 不斷檢查已建立起來的過程，以保證符合策略和各種規(guī)程并遵守有關標準和指南 15 項目管理者在開發(fā)前應決定的事項 ? 要求哪些類型的文檔 ? 提供多少種文檔 ? 文檔包含的內容 ? 達到何種級別的質量水平 ? 何時產生何種文檔 ? 如何保存、維護文檔以及如何進行通信 ? 如果一個軟件合同是有效的，應要求文檔滿足所接受的標準，并規(guī)定所提供的文檔類型、每種文檔的質量水平以及評審和通過的規(guī)程。 16 主要內容 ? 軟件文檔的作用 ? 管理者的作用 ? 制訂文檔編制策略 ? 制訂文檔編制標準和指南 ? 文檔編制計劃 ? 制訂文檔規(guī)程 ? 所需資源 17 制訂文檔編制策略 ? 文檔策略由上級 (資深 )管理者準備并支持，對下級開發(fā)單位或開發(fā)人員提供指導。 ? 策略規(guī)定主要的方向，不是做什么或如何做的詳細說明。 ? 一般說來，文檔編制策略陳述要明確，并通告到每個人且理解它，進而使策略被他們貫徹實施。 18 支持有效文檔策略的基本條件 ? 文檔需要覆蓋整個軟件生存期 ?在項目早期幾個階段就要求有文檔，而且在貫穿軟件開發(fā)過程中必須是可用的和可維護的。在開發(fā)完成后，文檔應滿足軟件的使用、維護、增強、轉換或傳輸。 ? 文檔應是可管理的 ?指導和控制文檔的獲得和維護，管理者和發(fā)行專家應準備文檔產品、進度、可靠性、資源，質量
公司管理相關推薦
鄂ICP備17016276號-1