軟件文檔質(zhì)量評價(jià)方法研究

陳琪 葛志松 許駿龍

摘要：隨著軟件開發(fā)工程化的發(fā)展，人們已經(jīng)注意到開發(fā)文檔是軟件產(chǎn)品的重要組成部分，軟件文檔質(zhì)量的好壞直接影響到軟件的開發(fā)、使用和維護(hù)。在相關(guān)軟件測試標(biāo)準(zhǔn)中，已將文檔審查列為一種正式的測試類型，但是相較于傳統(tǒng)的測試類型，文檔測評還沒有形成較為系統(tǒng)、形式化的方法。基于此，該文提出一種適用于軟件文檔質(zhì)量評價(jià)的綜合方法。

關(guān)鍵詞：軟件文檔；質(zhì)量評價(jià)；評價(jià)模型

中圖分類號：TP311 文獻(xiàn)標(biāo)識(shí)碼：A 文章編號：1009-3044（2018）30-0060-02

1 概述

文檔測評范圍應(yīng)根據(jù)上級要求、測評任務(wù)書、合同或其他等效文件綜合確定，一般包括被測軟件需求規(guī)格說明、設(shè)計(jì)說明、用戶手冊等。文檔測試與程序測試有很大不同，文檔是不可運(yùn)行的。經(jīng)過長期試驗(yàn)，筆者認(rèn)為比較有效的文檔測試方法主要分為兩類：審查，參照編寫依據(jù)閱讀文檔，與同一系列或相關(guān)軟件文檔產(chǎn)品相對比；驗(yàn)證，文檔與程序運(yùn)行情況相比對。

在實(shí)際工作中，文檔審查工作經(jīng)常在軟件測試之前實(shí)施，基于人力資源有限，文檔驗(yàn)證通常由測試人員在測試工作中同步實(shí)施，發(fā)現(xiàn)的問題通常會(huì)歸類到軟件問題。在該文中文檔質(zhì)量評價(jià)適用于文檔審查方法。

2 文檔質(zhì)量模型

在GJB5236-2004《軟件質(zhì)量度量》中適用于文檔質(zhì)量度量是“易用性”和“可維護(hù)性”2個(gè)質(zhì)量特性中的部分子特性，但這2個(gè)質(zhì)量特性的評價(jià)對象還包括可執(zhí)行程序，且“易用性”以最終用戶為評價(jià)者，增大了評價(jià)實(shí)施的復(fù)雜度，因此必須建立適合文檔特點(diǎn)的質(zhì)量度量模型。

在該文中，參考GJB5236-2004《軍用軟件質(zhì)量度量》的質(zhì)量度量框架將文檔質(zhì)量歸納為4個(gè)質(zhì)量特性：完整性、一致性、準(zhǔn)確性和規(guī)范性；結(jié)合最新的文檔評估國際標(biāo)準(zhǔn)[1][2]、GJB438-88《軍用軟件文檔編制規(guī)范》[3]、GJB438A-97《武器軟件開發(fā)文檔》[4]等工程化標(biāo)準(zhǔn)，將質(zhì)量特性進(jìn)一步細(xì)分為若干個(gè)度量，規(guī)定了度量準(zhǔn)則，形成了一個(gè)文檔質(zhì)量度量模型。

2.1 完整性度量

完整性度量指文檔產(chǎn)品為指定的軟件和功能提供完整說明的能力。

2.1.1 一致性度量

一致性度量指文檔內(nèi)部和文檔之間說明的一致性能力。

2.1.2 正確性度量

2.1.3 規(guī)范性度量

3 文檔質(zhì)量評價(jià)模型

文檔質(zhì)量評價(jià)模型由文檔質(zhì)量要素評價(jià)、單個(gè)文檔質(zhì)量評價(jià)和文檔質(zhì)量綜合評價(jià)3級評價(jià)體系結(jié)構(gòu)組成，如圖1所示。 圖中實(shí)線表示組成關(guān)系，虛線箭頭表示評價(jià)過程。

文檔審查是基于評審組的測評方式，并依據(jù)通過認(rèn)可的文檔審查單對文檔進(jìn)行審查和打分。在此基礎(chǔ)上依據(jù)文檔問題和專家打分情況對文檔質(zhì)量進(jìn)行評價(jià)。

3.1 文檔質(zhì)量要素評價(jià)

文檔質(zhì)量要素評價(jià)，是指對組成文檔質(zhì)量的各項(xiàng)要素進(jìn)行評價(jià)。質(zhì)量要素基于度量元，結(jié)合文檔類型、文檔所依據(jù)的國家及軍用標(biāo)準(zhǔn)要求及測試要求確定。質(zhì)量要素確定后，需根據(jù)質(zhì)量要素要求分類制定詳細(xì)的文檔審查內(nèi)容，形成審查單，審查單需通過評審確認(rèn)。

文檔質(zhì)量要素評價(jià)完成后，需根據(jù)文檔質(zhì)量要素所屬的度量元評價(jià)結(jié)果計(jì)算每個(gè)度量元的度量結(jié)果。

3.2 單個(gè)文檔質(zhì)量評價(jià)

依據(jù)每個(gè)度量元的結(jié)果計(jì)算所屬質(zhì)量特性的結(jié)果。

3.3 文檔綜合質(zhì)量評價(jià)

根據(jù)單個(gè)文檔質(zhì)量評價(jià)結(jié)果，計(jì)算軟件文檔質(zhì)量的綜合質(zhì)量結(jié)果。

3.4 計(jì)算公式

對文檔質(zhì)量進(jìn)行評價(jià)時(shí)，每一級都需考慮其下級各質(zhì)量因素的權(quán)重，因此通用的文檔質(zhì)量評價(jià)結(jié)果計(jì)算公式如下：

3.5 權(quán)值計(jì)算方法

AHP是一種被廣泛應(yīng)用的決策方法，適用于建立了層次機(jī)構(gòu)的評價(jià)模型，它可以更好地對專家經(jīng)驗(yàn)進(jìn)行處理，使得權(quán)重值的確定結(jié)果更加合理。但該方法依賴于數(shù)據(jù)的長期積累，且實(shí)施時(shí)計(jì)算量較大，因此，該方法適用于數(shù)據(jù)積累到一定程度且時(shí)間比較充裕的評價(jià)過程。該文中主要選用AHP中的判斷矩陣構(gòu)造和權(quán)重向量求解方法。

參考文獻(xiàn)：

[1] ISO-IEC， ISO-IEC_26513_（E）. Software and systems engineering — Requirements for assessors and testers of user documentation[Z]. ISO-IEC， 2007.

[2] ISO-IEC， ISO/IEC25051. Software engineering – Software product Quality Requirements and Evaluation （SQuaRE） – Requirements for quality of Commercial Off-The-Self （COTS） software product and instructions for testing[Z]. ISO-IEC， 2006.

[3] 總裝備部， GJB 438-88. 軍用軟件文檔編制規(guī)范[Z]. 北京： 總裝備部， 1988.

[4] 總裝備部， GJB 438A-97. 武器軟件開發(fā)文檔[Z]. 北京： 總裝備部， 1997.

【通聯(lián)編輯：謝媛媛】