件在規(guī)模上和復(fù)雜程度上差別極大,本指南認(rèn)為在文件編制工作中應(yīng)允許一定的靈活性,并不是14種文件每種都必須編寫。
文件編制的衡量因素
◆在因素總和較低的情況下,項(xiàng)目開(kāi)發(fā)總結(jié)報(bào)告的內(nèi)容應(yīng)包括:程序的主要功能、基本流程、測(cè)試結(jié)果和使用說(shuō)明。
◆測(cè)試分析報(bào)告應(yīng)該寫,但不必很正規(guī)。
◆數(shù)據(jù)要求說(shuō)明和數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明是否需要編寫應(yīng)根據(jù)所開(kāi)發(fā)軟件的實(shí)際需要來(lái)決定。
例2:為了避免在軟件開(kāi)發(fā)中文件編制的不足或過(guò)分,一個(gè)簡(jiǎn)便的辦法是把對(duì)軟件文件的編制要求同軟件的規(guī)模大小聯(lián)系起來(lái),這就是本例的出發(fā)點(diǎn)。軟件的規(guī)模不妨分為四級(jí):
1.小規(guī)模軟件源程序行數(shù)小于5 000的軟件;
2.中規(guī)模軟件源程序行數(shù)為 10 000~ 50 000的軟件;
3.大規(guī)模軟件源程序行數(shù)為 100 000?500 000的軟件;
4.特大規(guī)模軟件源程序行數(shù)大于500 000的軟件。
對(duì)上述的四級(jí)軟件的文件編制要求分別列于表O3。
至于源程序行數(shù)為 5 000~ 10 000, 50 000~ 100 000的軟件,其文件編制要求介于兩級(jí)之間,可根據(jù)一個(gè)軟件產(chǎn)品的具體情況,由項(xiàng)目負(fù)責(zé)人參照表O3的規(guī)定,確定需要編制的文件種類。
對(duì)于源程序行數(shù)大于500 000的特大規(guī)模軟件,可進(jìn)一步把本指南規(guī)定的十四種文件按實(shí)際需要擴(kuò)展成更多種類。