specifications - 是什么让一个伟大的功能规范伟大？

Question

是什么品质使它如此出色，与您必须处理的不太出色的规范相比，是什么让它脱颖而出？或者，如果您以前从未使用过一个好的功能规范，那么您希望在一个好的规范中会发生什么样的事情？

抱歉，这显然是主观的，但我正在创建一个功能规范(不是我的第一个)，我突然想到我可能会从 SO 上的聪明人那里得到一些好主意!

Answer 1

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

可悲的是，我个人收到的规范并不是那么出色。通常，它们只是他们期望从系统的每个部分获得的功能的项目符号列表，并且他们希望您解决所有细节。我猜这很好。但是，我正在为我作为个人项目工作的 RPG 游戏编写游戏设计文档，并且我认为我正在编写的规范写得非常好。我已将游戏分为多个部分，例如

人物

武器和盔甲

级别

map

物理

等等，并从游戏玩法以及一些技术细节方面描述了每个部分。它很容易解决。

我也强烈推荐阅读 Painless Functional Specs Series来自 Joel 关于软件的任何有兴趣编写更好规范的人。