【正文】 維護人員負責(zé)收集、記錄從用戶或其他途徑反饋回來的軟件質(zhì)量信息 ? 在分析整理后，填寫 “ 軟件問題報告 ” ? 由軟件維護人員或項目課題組人員根據(jù) “ 軟件問題報告 ” 中提出的要求，填寫 “ 軟件修改申請報告 ” ? 根據(jù)批準(zhǔn)后的 “ 軟件修改申請報告 ” ，由該項目的課題組人員或軟件維護人員對程序進行修改、測試 66 文檔維護步驟 (續(xù) ) ? 測試通過后，由程序修改人員填寫 “軟件修改報告”并修改相應(yīng)的文檔和媒體 ? 將“軟件修改報告”和修改后的文檔送審核、會簽、標(biāo)準(zhǔn)化、批準(zhǔn)等有關(guān)負責(zé)人審閱、簽署 ? 將修改后的文檔、媒體和“軟件修改報告”送檔案管理部門存檔 ? 軟件維護人員匯總并整理修改情況，在此基礎(chǔ)上編寫“軟件維護通報” 67 主要內(nèi)容 ? 軟件文檔的作用 ? 管理者的作用 ? 制訂文檔編制策略 ? 制訂文檔編制標(biāo)準(zhǔn)和指南 ? 文檔編制計劃 ? 制訂文檔規(guī)程 ? 所需資源 68 所需資源 ? 為了編制高質(zhì)量文檔，必須得到必要的資源 ? 所需的資源包括： ?人員 ?設(shè)備 ?資金 69 (1) 人員 ? 技術(shù)工作和技術(shù)管理主要取決于人。 ? 在制定計劃過程中應(yīng)請文檔專家和通曉文檔工作的人協(xié)助制定合理的預(yù)算。在人為事故或自然災(zāi)害情況下，可以使用備用的磁帶、磁盤、軟盤、清單、系統(tǒng)圖等重新構(gòu)造系統(tǒng)。 56 (2) 設(shè)計評審 ? 通常安排兩個主要的設(shè)計評審 ?概要設(shè)計評審 ?在概要設(shè)計評審過程中，主要詳細評審每個系統(tǒng)組成部分的基本設(shè)計方法和測試計劃。 ? 這些規(guī)程內(nèi)含審批、質(zhì)量保證及若干控制點，概述修改步驟、存儲和維護要求以及更新方法。 34 1級文檔 ? 最低限度文檔 ? 適合開發(fā)工作量低于一個人月的開發(fā)者自用程序。 21 主要內(nèi)容 ? 軟件文檔的作用 ? 管理者的作用 ? 制訂文檔編制策略 ? 制訂文檔編制標(biāo)準(zhǔn)和指南 ? 文檔編制計劃 ? 制訂文檔規(guī)程 ? 所需資源 22 制訂文檔編制標(biāo)準(zhǔn)和指南 ? 在一個機構(gòu)內(nèi)部，應(yīng)采用一些標(biāo)準(zhǔn)和指南： ?軟件生存期模型 ?文檔類型和相互關(guān)系 ?文檔質(zhì)量 ? 這些標(biāo)準(zhǔn)和指南將決定如何實現(xiàn)文檔任務(wù)，將提供一些準(zhǔn)則以評價該機構(gòu)內(nèi)所產(chǎn)生的軟件文檔的完整性、可用性和適合性。 12 管理者對文檔工作的責(zé)任 ? 管理者要認識到正式或非正式文檔都是重要的，還要認識到文檔工作必須包括文檔計劃、編寫、修改、形成、分發(fā)和維護等各個方面。 ? 本標(biāo)準(zhǔn)期望應(yīng)用于各種類型的軟件，從簡單的程序到復(fù)雜的軟件系統(tǒng)。例如，技術(shù)文件、設(shè)計文件、版本說明文件。 19 支持有效文檔策略的基本條件 ? 文檔應(yīng)適合于它的讀者 ?讀者可能是管理者、分析員、無計算機經(jīng)驗的專業(yè)人員、維護人員、文書人員等。通過規(guī)定軟件、主題事項、文檔編制、質(zhì)量保證人員以及包含在開發(fā)過程中任何其他事項的角色來定義做什么，如何做和何時做 ? 用作檢驗點而允許管理者評定開發(fā)進度。應(yīng)該編寫文檔計劃并把它分發(fā)給全體開發(fā)組成員，作為文檔重要性的具體依據(jù)和管理部門文檔工作責(zé)任的備忘錄 ? 對于小的、非正式的項目，文檔計劃可能只有一頁紙； ? 對于較大的項目，文檔計劃可能是一個綜合性的正式文檔，這樣的文檔計劃應(yīng)遵循各項嚴(yán)格的標(biāo)準(zhǔn)及正規(guī)的評審和批準(zhǔn)過程。如果對文檔與開發(fā)工作的其他方面同樣重要這一點強調(diào)不夠，各種問題可能隨之而來。 ? 注：會簽是撰擬公文的過程中，主辦單位主動與有關(guān)單位協(xié)商并核簽的一種辦文程序，一般當(dāng)公文的內(nèi)容涉及本單位的多個部門或與其它單位有關(guān)時，需要進行會簽。計算機程序能夠提供圖表、索引、數(shù)據(jù)元素表以及子程序和其他程序成分之間的交叉引用。用于檢查文檔的一致性及在需求、設(shè)計文檔和計算機代碼之間提供相關(guān)性的計算機技術(shù)也已經(jīng)開發(fā)成功。 62 (1) 文檔歸檔 ? 歸檔的文檔應(yīng)包括整個軟件生存期內(nèi)所形成的全部文檔。一開始特別重要的是 需求規(guī)格說明 和 設(shè)計規(guī)格說明 的評審。如同任何別的計劃一樣，文檔計劃指出未來的各項活動，當(dāng)需要修改時必須加以修改。 27 基本的開發(fā)文檔 ? 可行性研究和項目任務(wù)書 ? 需求規(guī)格說明 ? 功能規(guī)格說明 ? 設(shè)計規(guī)格說明，包括程序和數(shù)據(jù)規(guī)格說明 ? 開發(fā)計劃 ? 軟件集成和測試計劃 ? 質(zhì)量保證計劃、標(biāo)準(zhǔn)、進度 ? 安全和測試信息 28 (2) 產(chǎn)品文檔 ? 產(chǎn)品文檔規(guī)定關(guān)于軟件產(chǎn)品的使用、維護、增強、轉(zhuǎn)換和傳輸?shù)男畔? ? 產(chǎn)品的文檔起到如下三種作用 ?為使用運行軟件產(chǎn)品的任何人規(guī)定培訓(xùn)和參考信息 ?使得那些未參加開發(fā)本軟件的程序員維護它 ?促進軟件產(chǎn)品的市場流通或提高可接受性 ? 產(chǎn)品文檔用于用戶、運行者和軟件維護人員 29 產(chǎn)品文檔內(nèi)容 ? 用于管理者的指南和資料 ?它們 是 用來監(jiān)督軟件的使用的 ? 宣傳資料 ?用于通告軟件產(chǎn)品的可用性