《軟體需求最佳實踐》閱讀筆記06

第7章需求描述最佳實踐

在描述需求時，我們首先確定以什麼風格來表述，另外還應該選擇與專案、團隊特點相符合的風格模板。

常見的描述風格與選用標準

在描述需求時，最常見的描述風格個可以分成自然語言、圖形化模型和形式化規格描述3種

自然語言，也就是使用結構合理的自然語言來描述需求，這種形式不管對於寫的人還是看的人，都是乙個很容易接受的方法，一直以來這都是描述需求的首選方法。

圖形化模型，圖形化模型在表述時能夠給讀者提供更強的視覺效果，同時能夠使問題更加聚焦。所以我們在日常的交流中，經常會在紙上繪製一些非標的、低保真的示意圖，以更好地完成溝通。

形式化規格描述，如果說圖形化建模的精確度比自然語言高的話，那麼形式化規格描述則比圖形化模型跟高。對於邏輯性很強、精度要求很高的場合，形式化規格描述就是一種不錯的選擇，其主要優點是嚴謹、精確；缺點是編寫和閱讀的人都會感到和困難，容易產生理解歧義。

選擇建議

a) 自然語言為主，複製以圖形化模型，需要的地方少量使用形式化規格描述。

b) 圖形化模型為主，輔之以自然語言作為補充，需要的地方少量使用形式化規格描述

c) 以形式化規格語言為主，輔之以圖形化模型，以自然語言為補充：適用於質量要求很高的領域。

文字表達的先天不足

a) 非文字資訊的缺乏導致資訊的丟失

b) 說著無心，聽者有意

不要忽視陳述需求理由的重要性

注意措辭

a) 盡可能減少使用定性詞語，定性詞語也就意味著不確定

i. 有效：什麼稱為有效地支援，具體表現在什麼地方？

ii. 依賴：什麼樣的依賴，流程依賴，還是其他什麼依賴關係？

b) 避免使用描述資料的詞語，另一類容易產生歧義的時對資料規則進行描述的詞語，這些都是容易產生疏忽，因此我們應該改為使用資料表示式來說明。

做好需求描述的核心秘訣在於謹記「資訊的有效傳遞」。在本章中，分析了集中典型的需求規格說明模板，闡釋了「溝通決定內容，內容決定格式」的道理本章強調了需求寫作是「結構化文字」為主的應用文，要避免使用定性的、表示資料的詞語，要盡量支出需求的理由，這樣就是更加有效地完成需求的文件化和資訊的傳遞。