【正文】 計(jì)劃應(yīng)包括對(duì)下述內(nèi)容的評(píng)審和認(rèn)可： ?編排方式 ?技術(shù)準(zhǔn)確度 ?復(fù)蓋范圍的完整性 ?對(duì)讀者的適合程度 ?圖表設(shè)計(jì)思想及最終圖表 (也應(yīng)接受關(guān)于技術(shù)準(zhǔn)確度、適合程度和完整性的單獨(dú)評(píng)審 ) ?在語(yǔ)法、標(biāo)點(diǎn)及其他行文技巧方面的正確性 ?對(duì)格式和別的標(biāo)準(zhǔn)的遵守程度 59 評(píng)審會(huì)步驟 ? 由軟件開(kāi)發(fā)單位負(fù)責(zé)人、用戶代表、開(kāi)發(fā)小組成員、科技管理人員和標(biāo)準(zhǔn)化人員等組成評(píng)審小組，必要時(shí)還可邀請(qǐng)外單位的專家參加； ? 開(kāi)會(huì)前由開(kāi)發(fā)單位負(fù)責(zé)人確定評(píng)審的具體內(nèi)容，并將評(píng)審材料發(fā)給評(píng)審小組成員，要求做好評(píng)審準(zhǔn)備 ? 由開(kāi)發(fā)單位負(fù)責(zé)人主持評(píng)審會(huì)，根據(jù)文檔編制者對(duì)該文檔的說(shuō)明和評(píng)審條目，由評(píng)審小組成員進(jìn)行評(píng)議、評(píng)審，評(píng)審結(jié)束應(yīng)作出評(píng)審結(jié)論，評(píng)審小組成員應(yīng)在評(píng)審結(jié)論上簽字。 55 (1) 需求評(píng)審 ? 需求評(píng)審進(jìn)一步確認(rèn)開(kāi)發(fā)者和設(shè)計(jì)者已了解用戶要求什么，及用戶從開(kāi)發(fā)者一方了解某些限制和約束。 這種方法就是將產(chǎn)品的設(shè)計(jì)文件按規(guī)定的技術(shù)特征 （ 功能 、 結(jié)構(gòu) 、 材料 、 用途 、工藝特征 ） ， 分為 10級(jí) ， 每級(jí)分為 10類 ， 每類分為10型 ， 每型又分為 10種 。導(dǎo)致對(duì)計(jì)劃作適當(dāng)修改的常規(guī)評(píng)審應(yīng)作為該項(xiàng)目工作的一部分，所有與該計(jì)劃有關(guān)的人員都應(yīng)得到文檔計(jì)劃 42 文檔計(jì)劃主要內(nèi)容 ? 列出應(yīng)編制文檔的目錄 ? 提示編制文檔應(yīng)參考的標(biāo)準(zhǔn) ? 指定文檔管理員 ? 提供編制文檔所需要的條件，落實(shí)文檔編寫人員、所需經(jīng)費(fèi)以及編制工具等 ? 明確保證文檔質(zhì)量的方法，為確保文檔內(nèi)容的正確性、合理性，應(yīng)采取一定的措施，如評(píng)審、鑒定等 ? 繪制進(jìn)度表，以圖表形式列出在軟件生存期各階段應(yīng)產(chǎn)生的文檔、編制人員、編制日期、完成日期、評(píng)審日期等。 37 4級(jí)文檔 ? 正式文檔 ? 適于要正式發(fā)行供普遍使用的軟件產(chǎn)品。管理者還必須確定文檔的質(zhì)量要求以及如何達(dá)到和保證質(zhì)量要求。 ? 因此，管理者應(yīng)選擇一個(gè)軟件生存期模型并保證該模型在他們機(jī)構(gòu)內(nèi)是適用的。 ? 文檔效應(yīng)應(yīng)貫穿到軟件的整個(gè)開(kāi)發(fā)過(guò)程中 ?在軟件開(kāi)發(fā)的整個(gè)過(guò)程中，應(yīng)充分體現(xiàn)文檔的作用和限制，即文檔應(yīng)指導(dǎo)全部開(kāi)發(fā)過(guò)程。 ? 策略規(guī)定主要的方向，不是做什么或如何做的詳細(xì)說(shuō)明。 ?該計(jì)劃主要描述要編制什么類型的文檔，這些文檔的內(nèi)容是什么，何時(shí)編寫，由誰(shuí)編寫，如何編寫，以及什么是影響期望結(jié)果的可用資源和外界因素。管理者可剪裁這些內(nèi)容以滿足他們的特殊需要。1 軟件文檔管理指南 (GB/T1668096) 2 簡(jiǎn)介 ? 本標(biāo)準(zhǔn)為那些對(duì)軟件或基于軟件產(chǎn)品的開(kāi)發(fā)負(fù)有職責(zé)的管理者提供軟件文檔的管理指南。 ? 本標(biāo)準(zhǔn)是針對(duì)文檔編制管理而提出的，不涉及軟件文檔的內(nèi)容和編排。 7 定義 ? 文檔等級(jí) level of documentation ?對(duì)所需文檔的一個(gè)說(shuō)明，它指出文檔的范圍、內(nèi)容、格式及質(zhì)量，可以根據(jù)項(xiàng)目、費(fèi)用、預(yù)期用途、作用范圍或其他因素選擇文檔等級(jí)。 ? 一般說(shuō)來(lái)，文檔編制策略陳述要明確，并通告到每個(gè)人且理解它，進(jìn)而使策略被他們貫徹實(shí)施。 20 支持有效文檔策略的基本條件 ? 文檔標(biāo)準(zhǔn)應(yīng)被標(biāo)識(shí)和使用 ?應(yīng)盡可能地采納現(xiàn)行的標(biāo)準(zhǔn)，若沒(méi)有合適的現(xiàn)行標(biāo)準(zhǔn)，必要時(shí)應(yīng)研制適用的標(biāo)準(zhǔn)或指南。管理者將會(huì)發(fā)現(xiàn)所進(jìn)行的階段和相應(yīng)任務(wù)的定義有助于監(jiān)控軟件項(xiàng)目的進(jìn)展。 ? 質(zhì)量要求的確定取決于可得到的資源、項(xiàng)目的大小和風(fēng)險(xiǎn)，可以對(duì)該產(chǎn)品的每個(gè)文檔的格式及詳細(xì)程度作出明確的規(guī)定。 ? 關(guān)鍵性程序或具有重復(fù)管理應(yīng)用性質(zhì) (如工資計(jì)算 )的程序需 4級(jí)文檔 ? 應(yīng)遵守 GB 8567的有關(guān)規(guī)定 38 文檔質(zhì)量 ? 質(zhì)量方面需要考慮的問(wèn)題即要包含文檔的結(jié)構(gòu)，也要包含文檔的內(nèi)容。 43 文檔計(jì)劃主要內(nèi)容 ? 此外，文檔計(jì)劃規(guī)定每個(gè)文檔要達(dá)到的質(zhì)量等級(jí)，以及為了達(dá)到期望的結(jié)果必須考慮哪些外部因素。 在特征標(biāo)記前 ， 冠以漢語(yǔ)拼音字母表示企業(yè)區(qū)分代號(hào) ， 在特征標(biāo)記后 ， 標(biāo)上三位數(shù)字 ， 表示登記號(hào) ， 最后是文件簡(jiǎn)號(hào) 。 ? 需求評(píng)審 (可能需要一次以上 )產(chǎn)生一個(gè)被認(rèn)可的需求規(guī)格說(shuō)明。 60 5. 文檔簽署 ? 軟件產(chǎn)品的所有文檔，都應(yīng)按規(guī)定進(jìn)行簽署 ? 軟件文檔簽署的順序一般按“編寫一審核－ 會(huì)簽 －標(biāo)準(zhǔn)化－批準(zhǔn)”的順序進(jìn)行。 ? 應(yīng)在不同的地點(diǎn)建立設(shè)施來(lái)保存重要文檔的副本。沒(méi)有任何指南、標(biāo)準(zhǔn)或方法 (學(xué) )能夠代替技術(shù)素質(zhì)高的人。 71 (3) 資金 ? 雖然開(kāi)發(fā)文檔的費(fèi)用很少作為單獨(dú)的預(yù)算項(xiàng)目，且產(chǎn)品文檔的費(fèi)用常常估計(jì)過(guò)低，但實(shí)際上開(kāi)發(fā)文檔和產(chǎn)品文檔的費(fèi)用卻占開(kāi)發(fā)費(fèi)用中的很大一部分。項(xiàng)目預(yù)算和計(jì)劃表必須反映這些費(fèi)用。但是，放在首位的仍然是任用既勝任計(jì)算機(jī)程序開(kāi)發(fā)、又勝任文檔工作的人員。如果文檔是聯(lián)機(jī)開(kāi)發(fā)的，則應(yīng)把它存儲(chǔ)到磁帶或磁盤上，以便能夠迅速地將這些文檔轉(zhuǎn)換成可用的形式。 ? 簽署不允許代簽。用戶代表必須積極參與開(kāi)發(fā)和需求評(píng)審，參與對(duì)需求文檔的認(rèn)可。