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