什么使一个伟大的功能规格伟大？

Question

与你不得不面对的那些不太好的规格相比，是什么特质让它如此出色，是什么让它脱颖而出？或者，如果您之前从未使用过良好的功能规范，那么您对优秀规格的期望是什么？

对不起，这显然是主观的，但我正在创建一个功能规范（不是我的第一个），而且我刚刚想到我可以从明亮的人那里得到一些好的想法！

Answer 1

来自Joel on Software的Project Aardvark specs是我迄今为止遇到的最好的。每个屏幕都定义得非常好，带有图片。描述了该软件的主要功能，以及一些技术细节。

可悲的是，我个人收到的规格并不那么精彩。通常它们只是他们期望从系统的每个部分获得的功能列表，他们希望您能够计算出所有细节。我想这哪个好。但是，我正在为一个RPG游戏编写游戏设计文档，我正在将其作为一个个人项目，我认为我写的规范编写得非常好。我已将游戏划分为诸如

之类的章节

• 字符
• 武器＆amp;装甲
• 级别
• 地图
• 物理

等等，并根据游戏玩法以及一些技术细节描述了每个部分。它很容易通过。

我强烈建议您阅读Joel on Software中的Painless Functional Specs Series，以便有兴趣编写更好规格的人。

Answer 2

恕我直言，关键的品质应该是功能规范详细说明了“什么”而不是“如何”。这样，请求者（营销？）得到了外观和他们想要的感觉和功能集，但实现留给那些最了解它的人 - 开发人员。

Answer 3

显然，规范应该是完整，一致和易于理解的。 IMO它也应该组织良好，因为它将产品特定部分的所有要求保持在一起。我不止一次读过规范，其中某些模块的要求分散在整个文档中，例如：一般性描述见第4章，但附加要求可以在第2章，第5章，第7章和附录B的条款中找到。要使用这样的规范，我首先要创建模块要求的交叉参考图。

Answer 4

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

这似乎很明显，但我通常得到的东西往往很模糊。显然，人们在纸上表达他们想要的东西并不容易，如果他们甚至知道他们想要什么。