从JSDoc生成Swagger YAML？

Question

我有一个JSDoc完整记录的大型JS API，并且我构建了一个基于REST的服务来使API在网络上可用。

我手动构建了YAML Swagger规范的初始版本，但问题是它快速与JS API不同步，因为它仍在不断发展，特别是在涉及的对象的属性中。

我想要做的是直接从JSDoc注释中自动生成Swagger YAML，至少是它的数据定义部分。有什么工具可以帮助我实现自动化吗？

Answer 1

swagger-jsdoc可能符合您的要求。