需求文檔寫作要點

 需求文檔寫作要點     

我的一篇老文章，偶然從機器裡找出來，與大家共勉。

需求的寫作形式一般分為兩種，物件導向和面向過程。對於不同的受眾和應用,採取不同的形式。
面向過程的形式：
主要的思想是IPO的原則，也就是“輸出－處理－輸出”
文檔格式，
一、首先是對於整體系統的簡略介紹：目的，確定文檔描述的對象和大體內容
二、系統上下文，介紹系統和其他系統之間的關係，邊界如何劃分
三、系統的需求分解，介紹完成整體系統需要分解的大架構的需求內容
四、具體需求
對於具體需求很簡單，按照如下形式完成：
1、簡介
2、輸入
3、處理
4、輸出
五、除了具體需求外，還包括其他相關方面的需求：
1、介面需求（與其他系統、子系統、模組的介面，使用者介面等）所謂的介面原型，其實是介面需求中的內容。由於介面原型通常都很重要，所以可以將這一部分拿出來放到具體需求中去。
介面原型不是僅僅一張圖，還包括介面元素的描述、範圍、錯誤提示資訊等
2、效能需求
3、依賴：依賴的資料庫、第三方軟體等
4、需求優先順序排序，用于衡量開發策略
六、參考文檔

物件導向的形式，整體文檔架構是和上面描述的一致，區別只有兩點。
一、在系統的需求分解處，用用例的包圖來描述、這個很簡單，其實就是上面文字描述的圖形化顯示
二、主要區別是具體需求，通過用例的形式來描述，包括
1、介紹
2、使用者（actor）
3、前置條件
4、後置條件
5、觸發條件
6、事件流
7、備選事件流
具體的寫法，可以參考《編寫有效用例》，這是寫用例我見過的最好參考書