技术和功能规格模板[关闭]

题

所以基本上我正在寻找好的模板来编写项目或工作请求的技术和功能规范。

你用什么？编写规格时您的了解有多深？如果您能提供任何其他一般提示，我们将不胜感激。

我的公司非常需要这些。我为承包商工作，现在我们根本不使用这些文件。

编辑： 我读过乔尔的看法无痛规格, ，我真的很喜欢它，但是还有其他意见吗:)

解决方案

一般提示；

我们正在实施一个流程

1) 业务需求声明（BRS）

2) 功能规格

3）技术规格

BRS 涵盖了业务问题是什么，以及围绕解决方案、测试、安全性、可靠性和交付的要求。这定义了什么才是成功的解决方案。

功能规范详细说明了需要什么、它应该是什么样子、字段应该有多长等等。

技术规范详细说明了数据的来源以及可能需要考虑的任何棘手代码。

客户拥有需求。开发人员拥有技术规格，而功能规格是中间立场。测试是根据技术规范（通常是单元测试）进行的，然后是根据功能规范（通常是系统测试）进行的，然后是根据需求（UAT）进行的。

其中重要的部分（也是我们正在努力解决的问题）是开发人员仍然需要交付功能规范和原始业务需求。事实上，功能和技术规格只是为了清晰起见。

简而言之，我的主要建议是首先制定出您想要实施的流程。然后寻求参与您提议的流程的所有各方的同意，然后处理适合的模板。模板本身只是您想要进行的更改的一小部分。

其他提示

不是模板，但 Joel 写了一个几篇文章关于编写功能规范。他还有样品在这里.

你可以从 ieee 和其他地方购买模板，但我总是自己制作模板。

对于技术规格，“代码完成史蒂夫·麦克唐纳（Steve McDonnell）有一个很好的清单，你可以从中获取一些信息。在我的上一份工作中，我只是根据他的部分标题制作了一个模板，并从那里对其进行了调整。

就功能规范而言，重要的是定义所有接口：

还应该有一个业务规则部分，这些规则在功能上很重要，但任何接口定义中都没有涵盖。

如果您想购买一本书， Karl Wiegers 的软件需求有一些文档的模板作为附录。不幸的是，我在工作，而那本书在家里。如果有人手边有它，他们也许能够确认这一点。

我碰巧喜欢这个，其中包括：准备就绪.

他也出售专业版。

从简单的开始，然后按照自己的方式工作。由于这是您第一次使用此内容，因此请使用带有要点的 Word 文档。写下来，重新阅读并提供足够的细节以使其有意义。对于技术规范，您可能希望引导开发人员找到解决方案，但对于功能规范，“如何”应该完全缺失。

我建议看看 Roberston's Volere 模板这里. 。他们与 Tom DeMarco 和 Timothy Lister 等因“Peopleware”而闻名的人都是大西洋系统协会的成员。

由于该模板受版权保护，我不会在这里复制它，但给您一些主要标题：

还有更多，但这应该能给您一个想法。该模板最有趣的部分是需求外壳，它在一种提示卡上列出了功能需求。再次受版权保护，但确实有价值。

看这里在第 9 章中。

许可以下： CC-BY-SA 和归因