如何寫好軟件說(shuō)明書(已修改)
2025-08-15 11:24 本頁(yè)面
【正文】 如何寫好軟件說(shuō)明書 你的工程應(yīng)該有個(gè)好的起點(diǎn)。一個(gè)小組要帶領(lǐng)客戶進(jìn)入需求啟發(fā)階段而且你要寫軟件需求說(shuō)明書。這份說(shuō)明有些大，但客戶會(huì)很重視，所以說(shuō)明必須得到贊同。 現(xiàn)在你正在設(shè)計(jì)其中的一個(gè)特性，已經(jīng)發(fā)現(xiàn)了需求的一些問(wèn)題。你可以用多種不同的方式解釋需求15；需求9 的說(shuō)明正好與需求21相反，你因該相信哪一個(gè)？需求24非常含糊，你根本不明白它的意思；你不得不花上一個(gè)小時(shí)與2位開(kāi)發(fā)人員討論需求30，只因?yàn)槟銈儗?duì)其各有各的理解；并且，唯一能夠澄清這些問(wèn)題的客戶沒(méi)有給你們答復(fù)。你被迫破解眾多需求的含義，并且你能預(yù)料到，如果你錯(cuò)了，你要做大量的重復(fù)工作。 許多軟件需求說(shuō)明書（SRS）寫得非常糟糕。任何產(chǎn)品的質(zhì)量需要其原始材料的質(zhì)量保證，糟糕的軟件需求說(shuō)明書不可能產(chǎn)出優(yōu)秀的軟件。不幸的是，幾乎沒(méi)有開(kāi)發(fā)人員受過(guò)與需求的抽象、分析、文檔、質(zhì)檢有關(guān)的教育。而且，沒(méi)有非常多的好需求可以借鑒學(xué)習(xí)，部分原因是很少有工程可以找到一個(gè)好的借鑒，其他原因是公司不愿意將其產(chǎn)品說(shuō)明書放在公共區(qū)域。 這篇文章描述了高質(zhì)量需求敘述和說(shuō)明的幾個(gè)特性（特點(diǎn)）。我們將用這些觀點(diǎn)檢查一些有缺陷的需求，帶著痛楚重新編寫。而且我會(huì)談一些如何編寫好的需求的提示。你也許想通過(guò)這些質(zhì)量標(biāo)準(zhǔn)評(píng)估你的工程需求。對(duì)于修訂，也許遲了，但你會(huì)學(xué)到一些有用的東西，并幫助你的小組在下次編寫出更好的需求?！ 〔灰谕軌蚓帉懗鲆环菽荏w現(xiàn)需求應(yīng)具備的所有特性的SRS。無(wú)論你怎么細(xì)化、分析、評(píng)論和優(yōu)化需求，都不可能達(dá)到完美。但是，如果你牢記這些特性，你就會(huì)編寫出更好的需求，生產(chǎn)出更好的產(chǎn)品?！ 「哔|(zhì)量需求敘述的特性 我們?nèi)绾螐囊恍┯袉?wèn)題的需求中分辨出好的軟件需求？這一節(jié)將分別介紹需求敘述應(yīng)體現(xiàn)的6個(gè)特性，下一節(jié)將從整體上介紹SRS文檔應(yīng)具備的特性。判斷每個(gè)需求是否具備應(yīng)有的特性的一種方式是由持有不同觀點(diǎn)的工程資金管理人所作的正規(guī)檢查。另一種有力的方法是在編寫代碼前依據(jù)需求編寫測(cè)試?yán)?。測(cè)試?yán)幽軌蛎鞔_顯現(xiàn)在需求中描述的產(chǎn)品行為（特性），能夠顯現(xiàn)缺陷、冗余和含糊之處。 正確：每個(gè)需求必須精確描述要交付的功能。正確性依據(jù)于需求的來(lái)源，如真實(shí)的客戶或高級(jí)別的系統(tǒng)需求說(shuō)明書。一個(gè)軟件需求與其對(duì)應(yīng)的系統(tǒng)需求說(shuō)明書相抵觸是不正確的（當(dāng)然，系統(tǒng)需求說(shuō)明書本身可能不正確）?！ ≈挥杏脩舻拇砟軌驔Q定用戶需求的正確性，這就是為什么在檢查需求時(shí)，要包括他們或他們的代理的關(guān)鍵所在
環(huán)評(píng)公示相關(guān)推薦
鄂ICP備17016276號(hào)-1