從JSDoc生成Swagger YAML？

Question

我有一個完整的JSDoc完整記錄的大型JS API，並且我正在構建一個基於swagger的REST服務，以使該API在網絡上可用。

我手動構建了YAML swagger規范的初始版本，但問題在於它與JS API迅速不同步，因為它仍在不斷發展，特別是在所涉及對象的屬性方面。

我想做的是直接從JSDoc注釋中自動生成不可靠的YAML，至少是其中的數據定義部分。 有沒有什么工具可以幫助我實現自動化？

Answer 1

swagger-jsdoc可能滿足您的要求。