資源描述：
《優(yōu)秀軟件需求文檔編寫(xiě)指南》由會(huì)員上傳分享，免費(fèi)在線(xiàn)閱讀，更多相關(guān)內(nèi)容在工程資料-天天文庫(kù)。
1、優(yōu)秀軟件需求文檔編寫(xiě)指南V1.0優(yōu)秀需求具有的特性■需求陳述的特征:1.完整性2.正確性3.可行性4.必要性5.劃分優(yōu)先級(jí)6.無(wú)二義性7.可驗(yàn)證性8.—致性9可修改性10可跟蹤性推薦的編寫(xiě)需求文檔的指南：定義標(biāo)準(zhǔn)的文檔結(jié)構(gòu)說(shuō)明如何使用文檔包含T需求概要構(gòu)造系統(tǒng)的業(yè)務(wù)案例定義專(zhuān)業(yè)術(shù)語(yǔ)安排好文檔的版面使文檔易讀幫助讀者查找信息使文檔易于變更推薦的需求描述指南:定義描述需求的標(biāo)準(zhǔn)模板使用淺顯、一致、簡(jiǎn)明的語(yǔ)言適當(dāng)?shù)厥褂脠D解其他需求描述輔助自然語(yǔ)言定量說(shuō)明需求惟一地標(biāo)識(shí)每個(gè)需求記錄需求源需求的理由L定義標(biāo)準(zhǔn)的文檔結(jié)構(gòu):為需求確定恰當(dāng)?shù)慕Y(jié)構(gòu)可有助于：-有利于讀者閱讀-最小化需
2、求的總量；-大量信息;-找出與具體問(wèn)題有關(guān)的需求集合；-發(fā)現(xiàn)遺漏和重復(fù)；-消除需求之間的矛盾；-管理迭代（例如延遲提岀的需求）;-拒絕差的需求;一剛古需求；-在多個(gè)項(xiàng)目中重用需求。-開(kāi)發(fā)軟件來(lái)支持符合通用標(biāo)準(zhǔn)的需求文檔產(chǎn)品定義標(biāo)準(zhǔn)的文檔結(jié)構(gòu):文檔一般是分層的，對(duì)于多個(gè)層次采用節(jié)和小節(jié)來(lái)組織。文檔層次是分類(lèi)的有用結(jié)構(gòu)，確定需求文檔結(jié)構(gòu)的一種方式，是使用通過(guò)標(biāo)題結(jié)構(gòu)能夠?qū)π枨笳Z(yǔ)句編目的節(jié)。采用這種方式,需求語(yǔ)句在文檔中的位置代表其一級(jí)分類(lèi)。（二級(jí)分類(lèi)可以通過(guò)指向其它節(jié)的鏈或通過(guò)屬性給岀。文檔結(jié)構(gòu)?IEEE/ANSI1830-1993a.引言a.l目的a.2文檔約定a.3
3、預(yù)期的讀者^(guò)閱讀建議a.4產(chǎn)品的范圍a.5參考文獻(xiàn)b綜合描述b.l產(chǎn)品的前景b.2產(chǎn)品的功能b.3用戶(hù)類(lèi)和特征b.4運(yùn)行環(huán)境b.5設(shè)計(jì)和實(shí)現(xiàn)上的限制a.6假設(shè)和依賴(lài)b.外部接口需求C.1用戶(hù)界面a.2硬件接口a.3軟件接口a.4通信接口b.系統(tǒng)特性b.l說(shuō)明和優(yōu)先級(jí)b.2激勵(lì)/響應(yīng)序列c.3功能需求d.其它非功能需求e丄性能需求c.2安全設(shè)施需求c.3安全性需求c.4軟件質(zhì)量屬性e.5業(yè)務(wù)規(guī)則e.6用戶(hù)文檔f.其它需求附錄A:詞匯表附錄B:分析模型附錄C:待確定問(wèn)題的列表文檔結(jié)構(gòu)-組織特殊信息系統(tǒng)的概述和開(kāi)發(fā)該系統(tǒng)的效益解釋所使用的技術(shù)術(shù)語(yǔ)的術(shù)語(yǔ)表系統(tǒng)服務(wù)或功能需求
4、的定義系統(tǒng)特性或如可靠性、安全性等非功能性需求的定義系統(tǒng)操作和系統(tǒng)開(kāi)發(fā)過(guò)程的約束系統(tǒng)的操作環(huán)境和該環(huán)境可能變更的走義詳細(xì)的系統(tǒng)規(guī)格說(shuō)明，它被表示成表示系統(tǒng)組件之間關(guān)系的系統(tǒng)模型。2?說(shuō)明如何使用文檔效益-減少閱讀的成本-明確知識(shí)要求實(shí)施-明確所針對(duì)不同類(lèi)型的讀者-明確理解文檔所需要的專(zhuān)業(yè)知識(shí)和技術(shù)背景-指向概述部分的指示器-明確第一次閱讀進(jìn)可以路過(guò)的部分-描述閱讀各部分的相關(guān)順序2?包含一個(gè)需求概要效益■更易于理解的需求文檔-幫助理解概要-關(guān)注關(guān)鍵需求，有利于建立需求的優(yōu)先級(jí)-作為文檔中的需求的映射，有助于讀者發(fā)現(xiàn)感興趣的需求實(shí)施-是重要的需求用編號(hào)的列表來(lái)表示-基
5、于某種分類(lèi)結(jié)構(gòu)，在表格中列出不同需求-通過(guò)把每個(gè)主要需求表示成圖上的一個(gè)結(jié)點(diǎn)，可以產(chǎn)生需求的圖形化視點(diǎn)3?構(gòu)造系統(tǒng)的業(yè)務(wù)案例效益-提供系統(tǒng)需求的一個(gè)理由-幫助評(píng)估需求變更-幫助理解包含特殊需求的原因?qū)嵤?放在需求文檔引言的單獨(dú)章節(jié)中-列出業(yè)務(wù)目標(biāo)-給出目標(biāo)系統(tǒng)有助于這些業(yè)務(wù)理由4?定義專(zhuān)業(yè)術(shù)語(yǔ)效益?避免需求文檔的讀者與作者之間的誤解-幫助讀者理解需求文檔-幫助不同作者使用相同的術(shù)語(yǔ)-減少混淆實(shí)施_定義一個(gè)標(biāo)準(zhǔn)的術(shù)語(yǔ)表-根據(jù)術(shù)語(yǔ)表修改需求文檔-例如：詞匯表2?安排好文檔版面使文檔易讀效益??使文檔易讀-讀的次數(shù)比寫(xiě)的次數(shù)多，因此-易于評(píng)審時(shí)發(fā)現(xiàn)更好的問(wèn)題實(shí)施-使用寬的
6、頁(yè)邊空白來(lái)使文本-節(jié)和小節(jié)的標(biāo)題采用一致的格式-少用著重號(hào)，一致地使用著重號(hào)-使用表格、標(biāo)號(hào)列表或數(shù)字列表來(lái)表示相關(guān)信息項(xiàng)的集合。-當(dāng)許多信息項(xiàng)必須表示成穩(wěn)定和變化兩部分時(shí)，使用表格來(lái)顯示共同點(diǎn)和不同點(diǎn)。-使用空白把方程式和文本分開(kāi)，并使用不同字體來(lái)表示它們。-如果要描述一系列事件或一個(gè)順序的過(guò)程，使用圖表來(lái)顯示過(guò)程的各個(gè)步驟。-不用使用復(fù)雜的圖表2?幫助讀者查找信息效益■易于用做系統(tǒng)參考-索引和目錄容易使需求規(guī)格說(shuō)明作為參考文檔-索引幫助讀者評(píng)審文檔實(shí)施-生成索引和目錄-出現(xiàn)在索引中的術(shù)語(yǔ)應(yīng)在正文中標(biāo)明-可以使用字處理系統(tǒng)中的自動(dòng)化工具來(lái)創(chuàng)建索引&使用文檔易于變更
7、效益■減少需求變更的成本-制作和分發(fā)新的需求文檔既昂貴又耗時(shí)，易于變更的文檔可以改變這種情況-有利于及時(shí)驗(yàn)證文檔實(shí)施（結(jié)合"安排好文檔的版面使文檔易讀"一起實(shí)施）-把文檔做成活頁(yè)-利用字處理系統(tǒng)的修訂模式-寫(xiě)文檔時(shí)，避免引用文檔中的其他頁(yè)碼-確保所有圖表都有標(biāo)簽，始終使用標(biāo)簽引用圖表-保持章簡(jiǎn)短以便整章可以被用戶(hù)替換-在單獨(dú)的頁(yè)上開(kāi)始新的一章-始終根據(jù)章給頁(yè)編號(hào)-如果有的話(huà)，使用使用字處理系統(tǒng)中制作圖、表等的相對(duì)引用的功能。以便能夠自動(dòng)變更引用。9?定義描述需求的標(biāo)準(zhǔn)模板效益■■需求前后一致，更加易懂-標(biāo)準(zhǔn)使得需求易于閱讀-標(biāo)準(zhǔn)使得需求易于收集-標(biāo)準(zhǔn)使得需求易于
