问题标签 [functional-specifications]

我们总是写函数或类，它们的逻辑非常复杂。如果这些结构没有规范，以后连我们自己都很难掌握。

你如何为复杂的函数和类编写规范？

请告诉我一些你自己的经历，但不仅仅是一些链接，谢谢。

我最近一直在阅读 Joel on Software，因此在过多参与开发之前， 我已经非常认同编写功能规范的想法。

我即将尝试创建一个简单的 2D 游戏（不是太简单的头脑），我真的可以看到收获 - 过去我刚刚开始编写非常简单的游戏，我发现自己陷入了困境或者一遍又一遍地重写相同的位，因为我突然意识到我不知道应该如何定义我的关卡，或者我意识到我希望能够跳跃，但这意味着完全重新考虑我的碰撞检测。

无论如何，所以我已经开始提出一个功能规范，但我有点挣扎 - 我可以看到并理解它的重点，但我之前并没有真正写过很多功能规范，所以我真的不知道如何开始。我在 Internet 上找到的示例很棒，但它们大多是基于流程的（用户提交表单 A，然后提交表单 B）等......这对于游戏的结构并没有太大的应用。

有人对如何构建/编写游戏规范有任何建议/示例吗？

您将现有应用程序的功能规范称为什么？我有一个现有的应用程序，我需要重做该应用程序。它没有文档，我被要求编写功能分解规范。分解应用程序没有问题，但我正在寻找要使用的文档模板。

开发功能规范从来都不是一种愉快的体验，但我觉得很好地规划一个项目是一种病态的快感。我想我有一些父亲的问题。

不管我自己的问题是什么，我都可以找到很多关于如何创建具有不同用途的单一功能规范的文章。有大量的模板和示例，而且我有一个很好的自己的库。但是，我发现很难找到任何人讨论一种以任何效率生成多种功能规范的方式。

有谁知道讨论如何管理快速生成不同类型的功能规范的过程的消息来源？假设一家提供 Web 应用程序的公司，可能使用像 ColdFusion 或 PhoneGap 这样的快速开发工具，或者体验在于工具的使用而不是最终结果的东西。所以功能规格可以有很多不同的地方。

谁能指出我管理这个过程的方法，以减轻从头开始构建每个过程的负担？

编辑 - 我真的很喜欢 OmniGraffle，但是我并不想保持外观和感觉或做任何视觉上的事情（如果可以索引过去的屏幕截图可能会很有用）。代码片段似乎更接近我想要的。但实际上我想我正在寻找存档/索引过去文本块的方法。

因此，如果我在一年前描述了一个采购订单系统，而我今天正在构建类似的东西，我想找到一年前的功能规范，以便从一些示例文本开始。

在我看来，这是一些新颖的写作软件，其中像代码片段一样，一段文本（场景，章节或简介或任何可以编写的内容，然后在整个主体中移动。yWriter 会这样做。但是我需要找到一种方法来索引/搜索这些大块文本的相关性。我希望能更多地了解这种系统。