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