OpenAPI 以外的规范 文档 a restful API 的规范
Specifications other than OpenAPI Specification to document a restful API
首先要对OpenAPI规范本身有一个清晰的认识，让我们看看它的官网是如何定义的(https://github.com/OAI/OpenAPI-Specification)：
The goal of The OpenAPI Specification is to define a standard,
language-agnostic interface to REST APIs which allows both humans and
computers to discover and understand the capabilities of the service
without access to source code, documentation, or through network
traffic inspection
问题： OpenAPI 定义了关于如何用 YAML 或 JSON 编写 API 文档的规范。现在问题来了，它是否是完成这项工作的唯一规范？或者还有其他替代方案吗？
我在网上查了一下，但没有得出结论。
注意：这个问题可能会问软件推荐，但是因为"Specification"不能调用"Software"所以我决定在Whosebug上问。
我学习了 Pluralsight 的在线课程，构建 REST 的五个基本工具 APIs，并且可以找到以下两个工具作为 OpenAPI 规格：
- RAML (http://raml.org/)
- API 蓝图 (https://apiblueprint.org/)
这是 OpenAPI 规范的两个备选方案，在某种程度上它们的规范更新更丰富。但是，由于它们非常新，因此没有得到组织的广泛认可，并且工具支持也很有限。他们目前支持的大多数工具都是基于云的。
首先要对OpenAPI规范本身有一个清晰的认识，让我们看看它的官网是如何定义的(https://github.com/OAI/OpenAPI-Specification)：
The goal of The OpenAPI Specification is to define a standard, language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection
问题： OpenAPI 定义了关于如何用 YAML 或 JSON 编写 API 文档的规范。现在问题来了，它是否是完成这项工作的唯一规范？或者还有其他替代方案吗？
我在网上查了一下，但没有得出结论。
注意：这个问题可能会问软件推荐，但是因为"Specification"不能调用"Software"所以我决定在Whosebug上问。
我学习了 Pluralsight 的在线课程，构建 REST 的五个基本工具 APIs，并且可以找到以下两个工具作为 OpenAPI 规格：
- RAML (http://raml.org/)
- API 蓝图 (https://apiblueprint.org/)
这是 OpenAPI 规范的两个备选方案，在某种程度上它们的规范更新更丰富。但是，由于它们非常新，因此没有得到组织的广泛认可，并且工具支持也很有限。他们目前支持的大多数工具都是基于云的。