描述更改和实现的文档的名称是什么？

Question

在我们的开发过程中，我们为每个任务/特性提供了描述

• API变化
• API逻辑
• 数据流(如果需要)
• 数据库更改
• 客户端应如何与新的/修改的API交互
• 澄清执行情况的其他资料

文档的目标受众是实现该功能的开发人员，因此他们可以根据文档实现该功能。

我不知道如何称呼这份文件。现在我们称它为“技术规范”，但我觉得它比这要稍微多一点。

任何想法都将不胜感激。

Answer 1

描述要根据某些需求实现的东西的文档确实是一种规范。

但是它的技术规格听起来像是只描述内部的东西。由于它还描述了客户端的逻辑和用法将如何变化，而不依赖于更改的实现方式，因此可以将其视为功能规范( API提供了一个技术“函数”)。