計算機軟件產(chǎn)品開發(fā)文件編制指南GB 8567-1988(1)[6]

5.2 重復性

本指南第二篇中將列出的這十四種文件的內(nèi)容要求中，顯然存在某些重復。較明顯的重復有兩類。引言是每一種文件都要包含的內(nèi)容，以向讀者提供總的梗概。第二類明顯的重復是各種文件中的說明部分，如對功能性能的說明、對輸入和輸出的描述、系統(tǒng)中包含的設備等。這是為了方便每種文件各自的讀者，每種產(chǎn)品文件應該自成體系，盡量避免讀一種文件時又不得不去參考另一種文件。當然，在每一種文件里，有關引言、說明等同其他文件相重復的部分，在行文上、在所用的術語上、在詳細的程度上，還是應該有一些差別，以適應各種文件的不同讀者的需要。

5.3 靈活性

鑒于軟件開發(fā)是具有創(chuàng)造性的腦力勞動，也鑒于不同軟件在規(guī)模上和復雜程度上差別極大，本指南認為在文件編制工作中應允許一定的靈活性。這種靈活性表現(xiàn)在如下各款。

5.3.1 應編制的文件種類

盡管本指南認為在一般情況下，一項軟件的開發(fā)過程中，應產(chǎn)生的文件有十四種，然而針對一項具體的軟件開發(fā)項目，有時不必編制這么多的文件，可以把幾種文件合并成一種。一般地說，當項目的規(guī)模、復雜性和成敗風險增大時，文件編制的范圍、管理手續(xù)和詳細程度將隨之增加。反之，則可適當減少。為了恰當?shù)卣莆者@種靈活性，本指南要求貫徹分工負責的原則，這意味著：

a: 一個軟件開發(fā)單位的領導機構應該根據(jù)本單位經(jīng)營承包的應用軟件的專業(yè)領域和本單位的管理能力，制定一個對文件編制要求的實施規(guī)定，主要是：在不同的條件下，應該形成哪些文件?這些文件的詳細程度?該開發(fā)單位的每一個項目負責人，必須認真執(zhí)行這個實施規(guī)定。這種規(guī)定的兩個例子可嘆 本指南的附錄o(參考件);

b.對于一個具體的應用軟件項目，項目負責人應根據(jù)上述實施規(guī)定，確定一個文件編制計劃，主 中包括:

(1)應該編制哪幾種文件，詳細程度如何?

(2)各個文件的編制負責人和進度要求;

(3)審查、批準的負責人和時間進度安排;

(4)在開發(fā)時期內(nèi)，各文件的維護、修改和管理的負責人，以及批準手續(xù)。

[1]  [2]  [3]  [4]  [5]  [6]  [7]  [8]  [9]  [10]  [11]