从JSDoc生成Swagger YAML？

Question

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

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

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

Answer 1

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