如何为现有产品编写软件需求

Question

几年来，一家公司开发了多学科(固件、软件、硬件)产品.从来没有编写过软件需求规范( SRS )。一个潜在的客户现在想要一个SRS。

有什么办法来写吗？读过密码了吗？编写用户手册并将其转换为需求？

Answer 1

最终用户对源代码不感兴趣。没有必要像那样深入杂草中。他们对整个产品感兴趣。

扪心自问：“产品是干什么用的？”与熟悉它的人一起工作，找出它所做的所有事情，并为每件事写一个或两个要求。

只要有可能，需求就应该是可测试的。考虑一下您将如何证明该产品能够按照需求的要求进行操作。“通过检查”的检验只能是最后的手段。

如果您特别需要一个软件需求文档，那么您需要首先计算出总体需求，这应该会告诉您软件需要做什么。

Answer 2

我会问为什么客户要求为现有软件编写软件需求规范。需求通常用于驱动设计和测试--您可以创建满足需求的设计，然后使用跟踪需求的测试来确认设计确实满足需求。

对于现有的软件(或任何现成的购买产品)，我推荐某种类型的软件设计描述(SDD)。测试--尤其是用BDD风格编写的测试--可以以涉众可以理解的方式描述软件系统的特性(功能和一些质量属性)。这可以作为SDD的一部分，使用适当的图形、表格和文本模型作为另一个组件。详细程度在很大程度上取决于您正在制作的产品类型以及与接收文档的客户的协议和关系。

如果SDD不合适或不合适，您必须与客户一起工作，才能确切地了解他们想要缓解的问题，并与他们一起找到解决这些问题的最佳方法。这可能意味着从SDD、代码或正在运行的系统反向工程SRS。