如何編寫優質的需求文檔(2)

　　4. 檢驗當 ADC 端的輸入電壓范圍在 0 到 1 伏之間的時候，系統工作是否正常

　　第七步：你的需求是否通俗易懂?

　　相比于我們原來的描述：“根據彎曲傳感器的輸出不同頻率來控制 LED 閃爍”，我們上面的那些需求描述顯得難以閱讀和理解。

　　我發現，讓需求文檔變得通俗易懂，最簡單辦法莫過于，把過于細節的東西抽取出來，然后以條目的形式單獨定義。

　　版本1

　　1. 彎曲傳感器應當保證至少在 100 毫秒內讀取一次數據(放到注釋單獨列出)

　　2. 切換 LED 的狀態，使其與彎曲傳感器的讀數保持一致

　　3. 當彎曲傳感器的讀數為 1 伏特時，LED 狀態切換的次數應當保持在平均一秒十次;當傳感器的讀數為 0 伏特時，LED 的切換次數應保持在一秒 1 次。

　　定義：

　　· 彎曲傳感器：輸入電壓位于 ADC 的X端。安全電壓范圍為 0 到 1 伏特(放到注釋單獨列出)

　　· LED 狀態：數字狀態由Y端輸出

　　這樣就好多了(盡管還不完美)。這些需求通俗易懂，不涉及到系統內部實現，且易于測試。對于系統行為的限定也僅僅限于需要做什么，點到為止。(例如，對彎曲傳感器的采樣頻率，在實現上也可以更高，只要不產生非預期行為，一切都可以)。

　　編寫需求就仿佛是在大腦中構建軟件的過程。因此要重于實作。

原文轉自：http://kb.cnblogs.com/page/135757/