【正文】 這些可避免令人乏味地重復錄入草案材料，并且容許自動地重新打印更新后的文檔。 61 6. 文檔歸檔與保管 ? 軟件產(chǎn)品的文檔是軟件開發(fā)過程的真實記錄 ,是重要的信息資源，因此必須實行集中統(tǒng)一管理，使之完善、安全并能有效地利用。 ? 對所有描述開發(fā)工作和產(chǎn)品的文檔進行評審是正規(guī)評審過程的組成部分。 41 文檔編制計劃 ? 編制計劃的工作應及早開始，對計劃的評審應貫穿項目的全過程。如果開發(fā)文檔丟失、不完整或過時，管理者將失去跟蹤和控制軟件項目的一個重要工具； ? 形成了維護人員所要求的基本的軟件支持文檔，而這些支持文檔可作為產(chǎn)品文檔的一部分； ? 記錄軟件開發(fā)的歷史。根據(jù)任務的執(zhí)行，他們要求不同的材料表示和不同的詳細程度。 ? 文檔（集） / 文檔編制 documentation ?一個或多個相關文檔的集合。 ? 本標準涉及策略、標準、規(guī)程、資源和計劃，管理者必須關注這些內容，以便有效地管理軟件文檔。 8 主要內容 ? 軟件文檔的作用 ? 管理者的作用 ? 制訂文檔編制策略 ? 制訂文檔編制標準和指南 ? 文檔編制計劃 ? 制訂文檔規(guī)程 ? 所需資源 9 軟件文檔的作用 ? 管理依據(jù) ? 質量保證 ? 軟件維護支持 ? 任務之間聯(lián)系的憑證 ? 培訓與參考 ? 歷史檔案 10 主要內容 ? 軟件文檔的作用 ? 管理者的作用 ? 制訂文檔編制策略 ? 制訂文檔編制標準和指南 ? 文檔編制計劃 ? 制訂文檔規(guī)程 ? 所需資源 11 管理者的作用 ? 管理者嚴格要求軟件開發(fā)人員和編制組完成文檔編制，并且在策略、標準、規(guī)程、資源分配和編制計劃方面給予支持。因此盡可能地使用工具是經(jīng)濟的、可行的。文檔的質量可以按文檔的形式和列出的要求劃分為四級。 44 主要內容 ? 軟件文檔的作用 ? 管理者的作用 ? 制訂文檔編制策略 ? 制訂文檔編制標準和指南 ? 文檔編制計劃 ? 制訂文檔規(guī)程 ? 所需資源 45 制訂文檔規(guī)程 ? 文檔編制規(guī)程應符合前述文檔策略，并適用于整個軟件產(chǎn)品生存期內文檔的編制和使用 ? 這些規(guī)程提出關于文檔的計劃、編制、評審、制作和分發(fā)的邏輯順序。用戶代表必須積極參與開發(fā)和需求評審，參與對需求文檔的認可。如果文檔是聯(lián)機開發(fā)的，則應把它存儲到磁帶或磁盤上，以便能夠迅速地將這些文檔轉換成可用的形式。項目預算和計劃表必須反映這些費用。沒有任何指南、標準或方法 (學 )能夠代替技術素質高的人。 60 5. 文檔簽署 ? 軟件產(chǎn)品的所有文檔，都應按規(guī)定進行簽署 ? 軟件文檔簽署的順序一般按“編寫一審核－ 會簽 －標準化－批準”的順序進行。 在特征標記前 ， 冠以漢語拼音字母表示企業(yè)區(qū)分代號 ， 在特征標記后 ， 標上三位數(shù)字 ， 表示登記號 ， 最后是文件簡號 。 ? 關鍵性程序或具有重復管理應用性質 (如工資計算 )的程序需 4級文檔 ? 應遵守 GB 8567的有關規(guī)定 38 文檔質量 ? 質量方面需要考慮的問題即要包含文檔的結構，也要包含文檔的內容。管理者將會發(fā)現(xiàn)所進行的階段和相應任務的定義有助于監(jiān)控軟件項目的進展。 ? 一般說來，文檔編制策略陳述要明確，并通告到每個人且理解它，進而使策略被他們貫徹實施。 ? 本標準是針對文檔編制管理而提出的，不涉及軟件文檔的內容和編排。管理者可剪裁這些內容以滿足他們的特殊需要。 ? 策略規(guī)定主要的方向，不是做什么或如何做的詳細說明。 ? 因此，管理者應選擇一個軟件生存期模型并保證該模型在他們機構內是適用的。 37 4級文檔 ? 正式文檔 ? 適于要正式發(fā)行供普遍使用的軟件產(chǎn)品。 這種方法就是將產(chǎn)品的設計文件按規(guī)定的技術特征 （ 功能 、 結構 、 材料 、 用途 、工藝特征 ） ， 分為 10級 ， 每級分為 10類 ， 每類分為10型 ， 每型又分為 10種 。 ? 產(chǎn)品文檔的計劃應包括對下述內容的評審和認可： ?編排方式 ?技術準確度 ?復蓋范圍的完整性 ?對讀者的適合程度 ?圖表設計思想及最終圖表 (也應接受關于技術準確度、適合程度和完整性的單獨評審 ) ?在語法、標點及其他行文技巧方面的正確性 ?對格式和別的標準的遵守程度 59 評審會步驟 ? 由軟件開發(fā)單位負責人、用戶代表、開發(fā)小組成員、科技管理人員和標準化人員等組成評審小組，必要時還可邀請外單位的專家參加； ? 開會前由開發(fā)單位負責人確定評審的具體內容，并將評審材料發(fā)給評審小組成員，要求做好評審準備 ? 由開發(fā)單位負責人主持評審會，根據(jù)文檔編制者對該文檔的說明和評審條目，由評審小組成員進行評議、評審，評審結束應作出評審結論，評審小組成員應在評審結論上簽字。 65 文檔維護步驟 ? 軟件產(chǎn)品完成后，確定軟件維護人員 ? 在軟件的運行過程中，由軟件