什么使一个伟大的功能规范伟大?

这个 Project Aardvark specs 从Joel那里,软件是迄今为止我遇到的最好的。每个屏幕都定义得很好,带有图片。介绍了该软件的主要特点和一些技术细节。

遗憾的是,我个人收到的规格没有那么好。通常,它们只是一个项目符号列表,列出了它们期望从系统的每个部分获得的特性,并且它们希望您能够解决所有的细节问题。我想没关系。但是,我正在为一个RPG游戏编写一个游戏设计文档,作为一个个人项目,我认为我正在编写的规范写得非常好。我把游戏分成了几个部分,比如

• 文字
• 武器和装甲
• 水平
• 地图
• 物理

等等,并描述了游戏的每个部分以及一些技术细节。工作很容易。

我也强烈推荐阅读 Painless Functional Specs Series 来自Joel的关于软件的文章,任何有兴趣写更好的规范的人都可以使用。

imho,一个关键的质量应该是功能规范详细地规定了“什么”,而不是“如何”。这样,请求者(市场营销?)获取他们想要的外观和功能集,但实现留给最了解它的开发人员。

显然,规范应该是完整的、一致的和可理解的。在我看来,它也应该组织得很好,因为它将产品某一特定部分的所有需求放在一起。我不止一次阅读过规范,其中一些模块的需求分散在整个文档中,例如,一般描述在第4章,但附加的需求可以在第2、5、7和附录B的条款中找到。要使用这种规范,我首先必须创建一个需求的交叉参考图。o模块。

良好的规范应该以清晰的方式说明应用程序应该做什么。

这似乎很明显,但我通常得到的东西往往很模糊。显然,人们在纸上表达自己想要的东西并不容易,即使他们知道自己想要什么。