GJB438C的前言中描述了與GJB 438B-2009相比的主要變化:
下面對這些變化作簡單的分析:
本次標準刪除了8個文檔種類,保留了20個文檔種類。文檔種類的縮編,應該是很多軟件開發(fā)人員喜聞樂見的,可以少寫不少文檔(雖然實際內容并沒有減少,只是以并入其他文檔或者以其他形式出現(xiàn)),再也不會出現(xiàn)沒有向用戶/第三方測評機構提供這些文檔被斥責:“必須提供,這是標準要求的!”。
新增的“總則”中,明確了文檔有紙質和電子介質兩種載體,有數(shù)據(jù)庫、電子交互文檔、文檔處理器兼容格式等電子格式。這是依據(jù)實際情況對標準的完善,對標準的實施沒有影響。 文檔組成中增加的關于數(shù)據(jù)庫或其他格式方面的要求,對于數(shù)據(jù)庫類的文檔需要考慮滿足組成要求的同時還要便于檢索,而對于常用的Word文檔沒有影響。 增加的頁號要求,與GJB438B中“頁碼編制”要求基本相同,對標準的實施沒有影響。
修訂內容包括:刪除了“3 測試依據(jù)”;測試環(huán)境增加了概述小節(jié),要求給出測試環(huán)境拓撲示意圖;測試項的描述增加了“測試方法”的描述。對于測試人員來說,只是增加了測試環(huán)境示意圖和測試方法的描述,增加的工作量不大。
修訂的運行方案說明、系統(tǒng)/子系統(tǒng)規(guī)格說明、接口需求規(guī)格說明、系統(tǒng)/子系統(tǒng)設計說明、接口設計說明、數(shù)據(jù)庫設計說明,在實施GJB5000A的時候多數(shù)都被裁剪,即便實施GJB5000B需要編寫,那也都是新增工作量,這里不再比較細節(jié)變化。
修訂內容包括:軟件概述增加了說明軟件部件開發(fā)類型(新開發(fā)還是重用)的要求;軟件研制過程增加了系統(tǒng)合格性測試要求,明確描述各工程活動的計劃起止時間、實際起止實踐、主要工作及完成情況、進度執(zhí)行情況;給出了描述滿足任務指標的示例;增加“質量保證要求”;增加軟件安全性等關鍵需求的滿足情況的描述。對于開發(fā)人員來說,增加的工作量較大。 總之,雖然GJB438C相較于GJB438B有很多修訂內容,但是也增加了一些示例,標準相對更好理解,按標準編寫文檔難度有所下降。 這正是: 文檔要求修訂多,只為文檔好編寫 編寫文檔看標準,這樣編寫準沒錯 參考書目:GJB438C-2021 軍用軟件開發(fā)文檔通用要求 作者簡介:王小雙,長期從事GJB5000推廣、實施、評價、改進的工作,創(chuàng)建《軟件工程之思》微信公眾號,一直在《軟件工程之思》分享GJB5000、CMMI、軟件工程的知識和感悟?,F(xiàn)致力于GJB5000咨詢以及軟件過程改進、軟件工程能力提升的研究工作。 |
|