如何寫好軟件說明書(參考版)
2024-08-14 11:24本頁面
【正文】 并且要記住，沒有高質(zhì)量的需求，軟件就象一盒巧克力，你永遠(yuǎn)不知道你會(huì)得到什么。文檔的多份文本要在同一時(shí)間內(nèi)全部更新，避免不一致性?！ ”苊庠赟RS中過多的申述需求。我曾看見過多個(gè)需求說明書前后不一致。不要在一個(gè)需求中使用“和”/“或”。 密切關(guān)注多個(gè)需求合成了單個(gè)需求。如果你認(rèn)為一小部分測試可以驗(yàn)證一個(gè)需求的正確，那么它已經(jīng)正確的細(xì)化了。要避免包含多個(gè)需求的長的敘述段落。換句話說，你是否需要SRS的編寫者的額外解釋幫助開發(fā)人員很好的理解需求，以便于設(shè)計(jì)和實(shí)現(xiàn)？如果是的話，在繼續(xù)工作前，需求還需要細(xì)化。使用術(shù)語，要保持一致性，并在術(shù)語表或數(shù)據(jù)字典中定義它們 要看需求是否被有效的定義，可以以開發(fā)人員的觀點(diǎn)看看。采用主動(dòng)語氣。請?jiān)诮M織軟件需求文檔時(shí)，嚴(yán)格遵從這些方針。編寫質(zhì)量需求的方針 編寫優(yōu)秀的需求是沒有公式化的方法的。我清楚有人做過，而且他們花在檢查上的每一分鐘都是值得的?！ ≡诶斫飧鱾€(gè)已完成的糟糕需求上，開發(fā)人員將會(huì)遇到的難題是：開發(fā)人員與客戶將會(huì)在審核需求，未達(dá)成共識(shí)前發(fā)生激烈的爭論。這是修改后的：系統(tǒng)應(yīng)校驗(yàn)輸入的主管號(hào)碼而不通過聯(lián)機(jī)的主全體主官號(hào)碼列表。我曾看過一些需求說明書，采用諸如：應(yīng)，將，應(yīng)該/將要等一些詞描述優(yōu)先級(jí)的細(xì)微差別。真感到絕望，什么是“如果可能”：如果技術(shù)上可行？如果主 全體主管號(hào)碼列表可以聯(lián)機(jī)獲得？要避免象“應(yīng)該”的這類不確切的詞。我們還指定了一個(gè)例外：如果沒有發(fā)現(xiàn)錯(cuò)誤，不產(chǎn)生錯(cuò)誤報(bào)告。如果沒有錯(cuò)誤，就不會(huì)產(chǎn)生錯(cuò)誤報(bào)告”。我不知道，你怎么驗(yàn)證這個(gè)需求?！ ±?．“HTML分析器可以產(chǎn)生HTML標(biāo)記錯(cuò)誤報(bào)告，幫助HTML入門者快速解決錯(cuò)誤”。由于沒有定義觸發(fā)條件，需求對設(shè)計(jì)沒有約束力。象這樣編寫需求也許更好一些：“用戶能夠在一個(gè)由特定觸發(fā)條件激活處于編輯的文檔中在顯示和隱藏所有HTML標(biāo)記間切換”。軟件要在某些條件下更改自己？或者用戶為了模仿更改要做一些動(dòng)作？而且，在文檔中改變顯示的范圍是多大：選中的文本，整個(gè)的文檔，或其他的？這也是個(gè)模糊的問題?！ ±?．“產(chǎn)品應(yīng)瞬間在顯示和隱藏不可打印字符間切換” 計(jì)算機(jī)在瞬間不能做任何事，所以這個(gè)需求不切實(shí)可行。 彌補(bǔ)缺陷，重寫需求的一種方法： 狀態(tài)信息 2．后臺(tái)任務(wù)管理器因該以誤差上下不超過10秒的60秒間隔，在用戶界面的指定位置顯示狀態(tài)信息 3．如果后臺(tái)進(jìn)程處理正常，那么應(yīng)該顯示任務(wù)已完成的百分?jǐn)?shù)/比 4．任務(wù)完成時(shí)，應(yīng)顯示相關(guān)的信息
環(huán)評(píng)公示相關(guān)推薦
鄂ICP備17016276號(hào)-1