規(guī)格說明中尋找錯誤的系統(tǒng)行為。
在編寫軟件需求規(guī)格說明,希望讀者牢記以下的建議:
對節(jié)、小節(jié)和單個需求的號碼編排必須一致。
在右邊部分留下文本注釋區(qū)。
允許不加限制地使用空格。
正確使用各種可視化強(qiáng)調(diào)標(biāo)志(例如,黑體、下劃線、斜體和其它不同字體)。
創(chuàng)建目錄表和索引表有助于讀者尋找所需的信息。
對所有圖和表指定號碼和標(biāo)識號,并且可按號碼進(jìn)行查閱。
使用字處理程序中交叉引用的功能來查閱文檔中其它項(xiàng)或位置,而不是通過頁碼或節(jié)號。
為了滿足軟件需求規(guī)格說明的可跟蹤性和可修改性的質(zhì)量標(biāo)準(zhǔn),必須唯一確定每個軟件需求。這可以使你在變更請求、修改歷史記錄、交叉引用或需求的可跟蹤矩陣中查閱特定的需求。由于要達(dá)到這一目的,用單一的項(xiàng)目列表是不夠的,因此,我將描述幾個不同的需求標(biāo)識方法,并闡明它們的優(yōu)點(diǎn)與缺點(diǎn)??梢赃x擇最適合你的方法。
(1) 序列號最簡單的方法是賦予每個需求一個唯一的序列號,例如SRS-13。當(dāng)一個新的需求加入到商業(yè)需求管理工具的數(shù)據(jù)庫之后,這些管理工具就會為其分配一個序列號(許多這樣的工具也支持層次化編號)。序列號的前綴代表了需求類型,例如SRS代表“軟件需求說明”。由于序列號不能重用,所以把需求從數(shù)據(jù)庫中刪除時,并不釋放其所占據(jù)的序列號,而新的需求只能得到下一個可用的序列號。這種簡單的編號方法并不能提供任何相關(guān)需求在邏輯上或?qū)哟紊系膮^(qū)別,而且需求的標(biāo)識不能提供任何有關(guān)每個需求內(nèi)容的信息。
(2) 層次化編碼這也許是最常用的方法。如果功能需求出現(xiàn)在軟件需求規(guī)格說明中第3 . 2部分,那么它們將具有諸如3.2.4.3這樣的標(biāo)識號。標(biāo)識號中的數(shù)字越多則表示該需求越詳細(xì),屬于較低層次上的需求。即使在一個中型的軟件需求規(guī)格說明中,這些標(biāo)識號也會擴(kuò)展到許多位數(shù)字,并且這些標(biāo)識也不提供任何有關(guān)每個需求目的的信息。如果你要插入一個新的需求,那么該需求所在部分其后所有需求的序號將要增加。刪除或移去一個需求,那么該需求所在部分其后所有需求的序號將要減少。但其他地方的引用將混亂,對于這種簡單的層次化編號的一種改進(jìn)方法是對需求中主要的部分進(jìn)行層次化編號,然后對于每個部分中的單一功能需求用一個簡短文字代碼加上一個序列號來識別。例如,軟件需求規(guī)格說明可能包含“第3.2.5部分—編輯功能”,并將此部分編寫成子模塊文檔,然后配置管理。
有時,你覺得缺少特定需求的某些信息。在解決這個不確定性之前,可能必須與客戶商議、檢查與另一個系統(tǒng)的接口或者定義另一個需求。使用“待確定”(to be determined, TBD或采用漢語拼音略寫DQD)符號作為標(biāo)準(zhǔn)指示器來強(qiáng)調(diào)軟件需求規(guī)格說明中這些需求的缺陷。通過這種方法,你可以在軟件需求規(guī)格說明中查找所要澄清需求的部分。記錄誰將解決哪個問題、怎樣解決及什么時候解決。把每個TBD編號并創(chuàng)建一個TBD列表,這有助于方便地跟蹤每個項(xiàng)目。
在繼續(xù)進(jìn)行構(gòu)造需求集合之前,必須解決所有的TBD問題,因?yàn)槿魏芜z留下來的不確定問題將會增加出錯的風(fēng)險(xiǎn)和需求返工。當(dāng)開發(fā)人員遇到一個TBD問題或其它模糊之處時,他可能不會返回到原始需求來解決問題。多半開發(fā)者對它進(jìn)行猜測,但并不總是正確的。如果有TBD問題尚未解決,而你又要繼續(xù)進(jìn)行開發(fā)工作,那么盡可能推遲實(shí)現(xiàn)這些需求,或者解決這些需求的開放式問題,把產(chǎn)品的這部分設(shè)計(jì)得易于更改。
編寫優(yōu)秀的需求文檔沒有現(xiàn)成固定的方法,最好是根據(jù)經(jīng)驗(yàn)進(jìn)行。從過去所遇到的問題中可使你受益匪淺。許多需求文檔可以通過使用有效的技術(shù)編寫風(fēng)格和使用用戶術(shù)語而不是計(jì)算機(jī)專業(yè)術(shù)語的方式得以改進(jìn)。
你在編寫優(yōu)秀的需求文檔時,希望讀者還需牢記以下幾點(diǎn)建議:
保持語
項(xiàng)目經(jīng)理勝任力免費(fèi)測評PMQ上線啦!快來測測你排多少名吧~
http://opto-elec.com.cn/pmqhd/index.html