編寫合格的軟件需求文檔
什么樣的軟件需求文檔才算是合格的軟件需求文檔?文檔作為溝通方式之一,目的是讓閱讀者理解想要表達的含義。軟件需求文檔同時是為了讓其閱讀者準確理解軟件項目的需求,明白想要做一個什么樣的系統(tǒng)。所以,能準確的讓需求文檔讀者(個人以為重點是項目組開發(fā)、測試)理解項目需求就是合格的軟件需求文檔。
軟件需求文檔就其涵蓋的內(nèi)容而言,應(yīng)包括功能需求、接口需求、質(zhì)量需求三個方面。功能需求描述部份應(yīng)涵蓋了系統(tǒng)的所有功能,關(guān)鍵性功能及細節(jié)應(yīng)描述清晰,涉及到流程的部分,應(yīng)形成閉環(huán)、狀態(tài)的轉(zhuǎn)換及條件應(yīng)該有一個清晰的描述。接口需求(這里主要是指和其他系統(tǒng)的接口)應(yīng)清晰的描述消息的物理信道、通信協(xié)議、錯誤校驗機制、消息體的數(shù)據(jù)格式等要求。質(zhì)量需求主要包括性能需求,如響應(yīng)速度、單機并發(fā)數(shù);安全性要求以及甲方未來可能面臨的安全性風險;可用性、可維護性等方面。
適當?shù)木帉?、排版形式有助于理解需求文檔。如場景描述、系統(tǒng)原型等形式展現(xiàn)用戶的需求。針對整體全局性的要求沒必要每個功能點都進行說明,可以在文檔中設(shè)置一個全局業(yè)務(wù)規(guī)則的頁面,減少重新性的描述,同時能將精力花在其他部分。如下圖所示:
隱形需求度的把握。在項目中處理基本的常識和經(jīng)過磨合的團隊達成共識的部份才能作為隱形需求,否則需求都應(yīng)該顯性化,如果不顯性化,則這個地方就可能造成風險。隱性需求度的把握很大程度上影響文檔的質(zhì)量。
如果是集中辦公的項目團隊,可以考慮將需求講解/評審會議的部分當做需求文檔的補充,需要把握的就是通過文檔項目組成員能回憶起需求講解/評審會議產(chǎn)品經(jīng)理的口述部分,至少會留有一印象,在記憶不太清晰的情況下可以再咨詢產(chǎn)品經(jīng)理而到達開發(fā)工作不返工的目的即可。
編寫合格的軟件需求文檔當然不僅僅只是上面提到的部分,也許有更多優(yōu)秀的方式、方法來編制需求文檔,歡迎各位來一起探討如何編寫合格的軟件需求文檔這個話題。
想了解更多?現(xiàn)在就開始免費體驗