Posted on 2007-07-06 11:39
tanzek 閱讀(616)
評論(0) 編輯 收藏
此節為第一部分的第六節：
輕松寫就功能規格說明書 第2節：什么是規格說明書？
下面是JOEL在規格說明書中都要給出的一些內容：
1、事先聲明。這純粹是出于自我保護目的。通常可以說：“該規格說明書還沒有完成”。
2、作者。人們應該擁有他們說明的事物的責任權與所有權。如果規格說明書出了錯，那么就應該有一個專門指派的規格說明書所有人，他的名字就印在規格說明書上，由他負責對規格說明書進行修訂。
3、情節。反映你心目中設想的人們將如何使用產品的真實生活情節。這就是要放內容的地方。情節越生動越真實，那么你在為實際的或者虛構的用戶設計產品時會做得越好。
4、非構建目標。其實就是不打算去做的事情，很可能就是產品將來沒有的特性，確認“我們不打算去做”。
5、概觀。規格說明書目錄，使閱讀者形成大體印象，讓細節變得有意義。
6、細節，細節，細節。每一條細節都應該有處理細節的決定，規格明書需要以文檔的形式描述出決定。
7、未盡事宜。對于規格說明書的第一個版本留下一些未盡事宜是允許的，這些需要描述出來以讓程序員知道并在實現代碼時進行考慮。
8、旁注。對于規格說明書，可能會有各種不同類型的讀者，考慮那些僅僅對團體中的某一類人帶來幫助的有用仿真陳述。
9、規格說明書需要保持時時更新的狀態。隨著產品的開發與新決定的做出，規格說明書的更新應該是不斷地持續下去的。規格說明書總是反映我們大家針對產品將如何工作而紀念品出的最佳理解。
JOEL通常在服備器的某個位置保存一份當前版本，一般而言是用帶有修訂標記的規格說明書副本，而非是重新的規格說明書版本來讓各位成員進行參考。