GB/T 16680-1996軟件文檔管理指南

中華人民共和國(guó)國(guó)家標(biāo)準(zhǔn)GB/T16680—1996neqISO/IECTR9294：1990軟件文檔管理指南Guidelinesforthemanagementofsoftwaredocumentation1996-12-18發(fā)布1997-07-01實(shí)施國(guó)家技術(shù)監(jiān)督局發(fā)布

GB/T16680-1996前言ISO/IEC前言引言范圍2引用標(biāo)準(zhǔn)定義34軟件文檔的作用5管理者的作用6制訂文檔編制策略7制訂文檔編制標(biāo)準(zhǔn)和指南文檔編制計(jì)劃制訂文檔規(guī)程10所需資源·….·…．··.··…·….·附錄A(提示的附錄)文檔策略檢查表附錄B(提示的附錄)文檔計(jì)劃?rùn)z查表附錄C(提示的附錄)文檔管理規(guī)程檢查表附錄D(提示的附錄)軟件文檔編制時(shí)間附錄E(提示的附錄）各評(píng)審點(diǎn)評(píng)審內(nèi)容附錄F(提示的附錄)軟件文檔簽署者

GB/T16680-1996前本標(biāo)準(zhǔn)非等效采用國(guó)際標(biāo)準(zhǔn)ISO/IECTR9294:1990《信息技術(shù)：軟件文檔管理指南》。本標(biāo)準(zhǔn)與ISO/IECTR9294的主要差別如下：個(gè)別章條作了調(diào)整；所引用的標(biāo)準(zhǔn)作了變更；C）定義部分增加了內(nèi)容；枝術(shù)要素充實(shí)了內(nèi)容，增加了一些實(shí)用措施。如：文檔編寫(xiě)、簽署、審查、歸檔和修改等內(nèi)容；e）附錄部分也作了調(diào)整和擴(kuò)充，主要是增加了附錄D、附錄E和附錄F。本標(biāo)準(zhǔn)的附錄A到附錄F均是提示的附錄。本標(biāo)準(zhǔn)由中華人民共和國(guó)電子工業(yè)部提出。本標(biāo)準(zhǔn)由電子工業(yè)部標(biāo)準(zhǔn)化研究所歸口。本標(biāo)準(zhǔn)起草單位：電子工業(yè)部標(biāo)準(zhǔn)化研究所、華東計(jì)算技術(shù)研究所。本標(biāo)準(zhǔn)主要起草人：馮惠、王家增、鄭人杰。

GB/T16680-1996ISO/IEC前言ISO(國(guó)際標(biāo)準(zhǔn)化組織)和IEC(國(guó)際電工委員會(huì))是世界性的標(biāo)準(zhǔn)化專門(mén)機(jī)構(gòu)。國(guó)家成員體(它們都是ISO或IC的成員國(guó))通過(guò)國(guó)際組織建立的各個(gè)技術(shù)委員會(huì)參與制定針對(duì)特定技術(shù)范圍的國(guó)際標(biāo)準(zhǔn)。ISO和IEC的各技術(shù)委員會(huì)在共同感興趣的領(lǐng)域內(nèi)進(jìn)行合作。與ISO和IC有聯(lián)系的其他官方和非官方國(guó)際組織也可參與國(guó)際標(biāo)準(zhǔn)的制定工作對(duì)于信息技術(shù),ISO和IEC建立了一個(gè)聯(lián)合技術(shù)委員會(huì),即ISO/IECJTCl.技術(shù)委員會(huì)的主要任務(wù)是制定國(guó)際標(biāo)準(zhǔn)，但在例外的情況下，技術(shù)委員會(huì)可以提出下列類型之一的技術(shù)報(bào)告：類型1:雖然一再努力，但仍不能獲得出版一項(xiàng)國(guó)際標(biāo)準(zhǔn)所需要的支持時(shí)；類型2:所討論的項(xiàng)目仍處于技術(shù)發(fā)展階段；類型3:技術(shù)委員會(huì)所收集到的數(shù)據(jù)不是來(lái)源于正式出版的國(guó)際標(biāo)準(zhǔn)(例如"目前工藝水平")時(shí)類型1和類型2技術(shù)報(bào)告在出版后3年內(nèi)應(yīng)提交復(fù)審,以決定是否將它們轉(zhuǎn)變成國(guó)際標(biāo)準(zhǔn)。類型3技術(shù)報(bào)告不是務(wù)必要進(jìn)行復(fù)審，除非它們提供的數(shù)據(jù)已被認(rèn)為不再有效或已經(jīng)沒(méi)有用。ISO/IECTR9294屬于類型3技術(shù)報(bào)告,它是由ISO/IECJTCl“信息技術(shù)”聯(lián)合技術(shù)委員會(huì)制定的

軟件生存期的所有階段都要求編制文檔。因此.文檔編制和維護(hù)是必需的并且從軟件的概念階段連續(xù)作用到它廢止。文檔編制開(kāi)始于軟件項(xiàng)目的初始階段，并貫穿于軟件的設(shè)計(jì)、開(kāi)發(fā)、測(cè)試、安裝、使用、修改和增強(qiáng)。僅當(dāng)軟件走到它的生命終點(diǎn)時(shí)才認(rèn)為文檔編制過(guò)程結(jié)束。文檔編制是任何軟件開(kāi)發(fā)項(xiàng)目成功的基礎(chǔ),并且文檔的產(chǎn)生需要有時(shí)間、人工和資金的支撐。管理的職責(zé)是保證這些資源有效地利用重要文檔的標(biāo)識(shí)以使軟件產(chǎn)品成功開(kāi)發(fā)并提高質(zhì)量。

中華人民共和國(guó)國(guó)家標(biāo)準(zhǔn)GB/T16680-1996軟件文檔管理指南neqISO/IECTR9294：1990Guidelinesforthemanagementofsoftwaredocumentation1范園本標(biāo)準(zhǔn)為那些對(duì)軟件或基于軟件的產(chǎn)品的開(kāi)發(fā)負(fù)有職責(zé)的管理者提供軟件文檔的管理指南。本標(biāo)準(zhǔn)的目的在于協(xié)助管理者在他們的機(jī)構(gòu)中產(chǎn)生有效的文檔。本標(biāo)準(zhǔn)涉及策略、標(biāo)準(zhǔn)、規(guī)程、資源和計(jì)劃，管理者必須關(guān)注這些內(nèi)容，以便有效地管理軟件文檔。本標(biāo)準(zhǔn)期望應(yīng)用于各種類型的軟件,從簡(jiǎn)單的程序到復(fù)雜的軟件系統(tǒng)。并期望復(fù)蓋各種類型的軟件文檔，作用于軟件生存期的各個(gè)階段。不論項(xiàng)目的大小，軟件文檔管理的原則是一致的。對(duì)于小項(xiàng)目，可以不采用本標(biāo)準(zhǔn)中規(guī)定的有關(guān)細(xì)節(jié)。管理者可剪裁這些內(nèi)容以滿足他們的特殊需要。本標(biāo)準(zhǔn)是針對(duì)文檔編制管理而提出的，不涉及軟件文檔的內(nèi)容和編排.2引用標(biāo)準(zhǔn)下列標(biāo)準(zhǔn)所包含的條文，通過(guò)在本標(biāo)準(zhǔn)中引用而構(gòu)成為本標(biāo)準(zhǔn)的條文。本標(biāo)準(zhǔn)出版時(shí)，所示版本均為有效，所有標(biāo)準(zhǔn)都會(huì)被修訂，使用本標(biāo)準(zhǔn)的各方應(yīng)探討使用下列標(biāo)準(zhǔn)最新版本的可能性，GB8566-88計(jì)算機(jī)軟件開(kāi)發(fā)規(guī)范GB8567—88計(jì)算機(jī)軟件產(chǎn)品開(kāi)發(fā)文件編制指南GB/T11457-1995軟件工程術(shù)語(yǔ)3定義本標(biāo)準(zhǔn)采用下列定義，其他定義見(jiàn)GB/T11457。3.1文檔document一種數(shù)據(jù)媒體和其上所記錄的數(shù)據(jù)。它具有永久性并可以由人或機(jī)器閥讀。通常僅用于描述人工可讀的內(nèi)容。例如，技術(shù)文件、設(shè)計(jì)文件、版本說(shuō)明文件。3.2文檔(集);文檔編制documentation一個(gè)或多個(gè)相關(guān)文檔的集合。3.3文檔計(jì)劃documentationplan-個(gè)描述文檔編制工作方法的管理用文檔。該計(jì)劃主要描述要編制什么類型的文檔，這些文檔的內(nèi)容是什么，何時(shí)編寫(xiě)，由誰(shuí)編寫(xiě)，如何編寫(xiě),以及什么是影響期望結(jié)果的可用資源和外界因素。3.4文檔等級(jí)levelofdocumentation