2008-09-09 50 views
60

所以基本上我正在尋找很好的模板來編寫技術和功能規格的項目或工作要求。技術和功能規格的模板

你用什麼?編寫規格時有多深?任何額外的一般技巧,你可以提供將不勝感激。

我的公司需要這些。我爲承包商工作,現在我們根本不使用這些文檔。

編輯:我已閱讀喬爾的花費大約Painless Specification,我真的很喜歡它,但是否有任何其他的意見:)

回答

31

在大會的提示;

我們正在實施

1)業務需求書(BRS的

2)的過程)功能規範

3)技術規範

的BRS涵蓋了業務問題是什麼,以及對解決方案,測試,安全性,可靠性和交付的要求。這定義了什麼可以成功解決問題。

功能規格細節需要什麼,應該怎麼看,長字段應該如何等

,其中數據來自任何棘手的代碼,需要考慮的技術規格細節。

客戶擁有要求。開發人員擁有技術規格,功能規格是中間立場。根據技術規格(通常是單元測試)進行測試,然後根據功能規格(通常是系統測試),然後根據要求(UAT)進行測試。

這個(我們正在努力)的重要部分是開發人員仍然需要交付功能規格和原始業務需求。實際上,功能和技術規格只是爲了清晰起見。

簡而言之,我的主要技巧是首先解決您希望實施的流程。然後尋求您所提議流程中涉及的所有各方的同意,然後在模板上進行調整。模板本身只是你想要改變的一小部分。

6

如果你想購買一本書,Software Requirements by Karl Wiegers有幾個文件作爲模板附錄。不幸的是,我在工作,那本書在家裏。如果有人有它的方便,他們可能能夠證實這一點。

7

你可以從ieee和其他地方購買模板,但我總是最終做出自己的模板。

對於技術規範,Steve McDonnell的「Code Complete」有一個很好的清單,你可以從中得到一些信息。在我上一份工作中,我剛剛從他的部分標題中製作了一個模板,並從那裏調整了它。

至於功能規格方面,重要的是要確定所有的接口:

  1. UI(屏幕原型)
  2. 軟件接口(插件等)
  3. 硬件接口(如適當)
  4. 通信接口(服務,電子郵件,短信等)

還應該有一個部分對於業務規則來說,功能上非常重要的事物在任何接口定義中都沒有涉及。

5

我碰巧喜歡這個,其中包括:ReadySet

他也出售專業版。

3

從簡單開始,從那裏開始工作。由於這是您的第一次使用此體驗的經驗,請使用帶有項目符號的Word文檔。寫下來,重新閱讀,並提供足夠的細節,這是有道理的。對於技術規範,您可能需要引導開發人員走向解決方案,但對於功能規範,「如何」應該完全沒有。

3

我建議看看Roberston的Volere模板here。他們是大西洋系統協會的成員,與湯姆德馬科和蒂莫西利斯特這樣的「Peopleware」成名人士一起工作。

爲模板受版權保護,我不會在這裏重現,但給你一些主要頭:

  1. 項目
  2. 利益相關者的目的
  3. 已獲授權的約束
  4. 命名約定和術語
  5. 相關事實和假設
  6. 工作範圍
  7. 業務數據模型和數據字典
  8. 產品的範圍
  9. 功能需求
  10. 外觀和感覺的要求 ...

還有很多,但是這應該給你一個理念。模板中最有趣的部分是需求shell,它列出了某種提示卡上的功能需求。再次受版權保護,但真正有價值。

here在第9章