?? gb8567-88-02.htm
字號:
<html> <p><strong><font size=5><strong><font face="" size=5>計</font></strong><strong><font face="" size=5>算機軟件產(chǎn)品開發(fā)文件編制指南</font></strong></font></strong><strong><font size=5><strong><font face="" size=5><font size=4>----GB 8567-88</font></font></strong></font></strong><strong><hr></strong><p align="center"><strong> </strong><strong> 第一篇文件的編制指導(dǎo) </strong><p><strong><br> </strong><strong>4 軟件生存周期與各種文件的編制</strong><br> 一項計算機軟件，從出現(xiàn)一個構(gòu)思之日起，經(jīng)過這項軟件開發(fā)成功投入使用，直到最后決定停止使 用，并被另一一項軟件代替之時止，被認為是該軟件的一個生存周期。一般地說這個軟件生存周期可以分成以下六個階段：可行性與計劃研究階段<br> 需求分析階段<br> 設(shè)計階段 <br> 實現(xiàn)階段 <br> 測試階段<br> 運行與維護階段 <br> 在可行性研究與計劃階段內(nèi)，要確定該軟件的開發(fā)目標(biāo)和總的要求，要進行可行性分析、投資一收益分析、制訂開發(fā)計劃，并完成應(yīng)編制的文件。<br> 在需求分析階段內(nèi)，由系統(tǒng)分析人員對被設(shè)計的系統(tǒng)進行系統(tǒng)分析，確定對該軟件的各項功能、性能需求和設(shè)計約束，確定對文件編制的要求，作為本階段工作的結(jié)果，一般地說，軟件需求說明書、數(shù)據(jù)要求說明書和初步的用戶手冊應(yīng)該編寫出來。<br> 在設(shè)計階段內(nèi)，系統(tǒng)設(shè)計人員和程序設(shè)計人員應(yīng)該在反復(fù)理解軟件需求的基礎(chǔ)上，提出多個設(shè)計，分析每個設(shè)計能履行的功能并進行相互比較，最后確定一個設(shè)計，包括該軟件的結(jié)構(gòu)、模塊的劃分、功能的分配以及處理流程。在被設(shè)計系統(tǒng)比較復(fù)雜的情況下，設(shè)計階段應(yīng)分解成概要設(shè)計階段和詳細設(shè)計階段兩個步驟。在一般情況下，應(yīng)完成的文件包括：概要設(shè)計說明書、詳細設(shè)計說明書和測試計劃初稿。<br> 在實現(xiàn)階段內(nèi)，要完成源程序的編碼、編譯（或匯編）和排錯調(diào)試得到無語法錯的程序清單，要開始編寫模塊開發(fā)卷宗，并且要完成用戶手冊、操作手冊等面向用戶的文件的編寫工作，還要完成測試計劃的編制。<br> 在測試階段，該程序?qū)⒈蝗娴販y試，已編制的文件將被檢查審閱。一般要完成模塊開發(fā)卷宗和測試分析報告，作為開發(fā)工作的結(jié)束，所生產(chǎn)的程序、文件以及開發(fā)工作本身將逐項被評價，最后寫出項目開發(fā)總結(jié)報告。<br> 在整個開發(fā)過程中（即前五個階段中），開發(fā)集體要按月編寫開發(fā)進度月報。<br> 在運行和維護階段，軟件將在運行使用中不斷地被維護，根據(jù)新提出的需求進行必要而且可能的擴充和刪改。<br> 對于一項軟件而言，其生存周期各階段與各種文件編寫工作的關(guān)系可見表互，其中有些文件的編寫工作可能要在若干個階段中延續(xù)進行。<br> 表1軟件生存周期各階段中的文件編制 <p><img alt="" src="63.gif" width="581" height="602"></p><p> </p><p><strong>5 文件編制中的考慮因素 </strong> <br> 文件編制是一個不斷努力的工作過程。是一個從形成最初輪廓，經(jīng)反復(fù)檢查和修改，直到程序和文件正式交付使用的完整過程。其中每一步都要求工作人員做出很大努力。要保證文件編制的質(zhì)量，要體現(xiàn)每個開發(fā)項目的特點，也要注意不要花太多的人力。為此，編制中要考慮如下各項因素。 <br> <strong>5.1文件的讀者<br> </strong> 每一種文件都具有特定的讀者。這些讀者包括個人或小組、軟件開發(fā)單位的成員或社會上的公眾、從事軟件工作的技術(shù)人員、管理人員或領(lǐng)導(dǎo)干部。他們期待著使用這些文件的內(nèi)容來進行工作，例如設(shè)計、編寫程序、測試、使用、維護或進行計劃管理。因此，這些文件的作者必須了解自己的讀者，這些文件的編寫必須注意適應(yīng)自己的特定讀者的水平、特點和要求。 <br> <strong>5．2 重復(fù)性<br> </strong> 本指南第二篇中將列出的這十四種文件的內(nèi)容要求中，顯然存在某些重復(fù)。較明顯的重復(fù)有兩類。引言是每一種文件都要包含的內(nèi)容，以向讀者提供總的梗概。第二類明顯的重復(fù)是各種文件中的說明部分，如對功能性能的說明、對輸入和輸出的描述、系統(tǒng)中包含的設(shè)備等。這是為了方便每種文件各自的讀者，每種產(chǎn)品文件應(yīng)該自成體系，盡量避免讀一種文件時又不得不去參考另一種文件。當(dāng)然，在每一種文件里，有關(guān)引言、說明等同其他文件相重復(fù)的部分，在行文上、在所用的術(shù)語上、在詳細的程度上，還是應(yīng)該有一些差別，以適應(yīng)各種文件的不同讀者的需要。<br> <strong>5．3 靈活性<br> </strong> 鑒于軟件開發(fā)是具有創(chuàng)造性的腦力勞動，也鑒于不同軟件在規(guī)模上和復(fù)雜程度上差別極大，本指南認為在文件編制工作中應(yīng)允許一定的靈活性。這種靈活性表現(xiàn)在如下各款。<br> <strong>5．3.1 應(yīng)編制的文件種類 <br> </strong> 盡管本指南認為在一般情況下，一項軟件的開發(fā)過程中，應(yīng)產(chǎn)生的文件有十四種，然而針對一項具體的軟件開發(fā)項目，有時不必編制這么多的文件，可以把幾種文件合并成一種。一般地說，當(dāng)項目的規(guī)模、復(fù)雜性和成敗風(fēng)險增大時，文件編制的范圍、管理手續(xù)和詳細程度將隨之增加。反之，則可適當(dāng)減少。為了恰當(dāng)?shù)卣莆者@種靈活性，本指南要求貫徹分工負責(zé)的原則，這意味著：<br> a: 一個軟件開發(fā)單位的領(lǐng)導(dǎo)機構(gòu)應(yīng)該根據(jù)本單位經(jīng)營承包的應(yīng)用軟件的專業(yè)領(lǐng)域和本單位的管理能力，制定一個對文件編制要求的實施規(guī)定，主要是：在不同的條件下，應(yīng)該形成哪些文件？這些文件的詳細程度？該開發(fā)單位的每一個項目負責(zé)人，必須認真執(zhí)行這個實施規(guī)定。這種規(guī)定的兩個例子可嘆 本指南的附錄o（參考件）；<br> b．對于一個具體的應(yīng)用軟件項目，項目負責(zé)人應(yīng)根據(jù)上述實施規(guī)定，確定一個文件編制計劃，主 中包括:<br> (1)應(yīng)該編制哪幾種文件，詳細程度如何？<br> （2）各個文件的編制負責(zé)人和進度要求；<br> （3）審查、批準(zhǔn)的負責(zé)人和時間進度安排； <br> （4）在開發(fā)時期內(nèi)，各文件的維護、修改和管理的負責(zé)人，以及批準(zhǔn)手續(xù)。 <br> 每項工作必須落實到人。<br> 這個文件編制計劃是整個開發(fā)計劃的重要組成部分；<br> C．有關(guān)的設(shè)計人員則必須嚴(yán)格執(zhí)行這個文件編制計劃。<br> <strong>5．3．2 文件的詳細程度<br> </strong> 從同一份提綱起草的文件的篇幅大小往往不同，可以少到幾頁，也可以長達幾百頁。對于這種差別 本指南是允許的。此詳細程度取決于任務(wù)的規(guī)模、復(fù)雜性和項目負責(zé)人對該軟件的開發(fā)過程及運行環(huán)與 所需要的詳細程度的判斷。<br> <strong>5．3.3 文件的擴展 <br> </strong> 當(dāng)被開發(fā)系統(tǒng)的規(guī)模非常大（例如源碼超過一百萬行）時，一種文件可以分成幾卷編寫，可以按其。 每一個系統(tǒng)分別編制，也可以按內(nèi)容劃分成多卷，例如：<br> 項目開發(fā)計劃可能包括：質(zhì)量保證計劃，<br> 配置管理計劃， <br> 用戶培訓(xùn)計劃， <br> 安裝實施計劃；<br> 系統(tǒng)設(shè)計說明書可分寫成：系統(tǒng)設(shè)計說明書，<br> 子系統(tǒng)設(shè)計說明書； <br> 程序設(shè)計說明書可分寫成：程序設(shè)計說明書，<br> ?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -