JSDocからSwagger YAMLを生成していますか？

Question

私は、JSDocで完全に文書化された大きなJS APIを持っており、ネットワーク上でAPIを利用できるようにするために、魅力的なRESTサービスを構築しています。

私は手動でYAML swagger仕様の初期バージョンを作成しましたが、問題は進化しているため、特に関連するオブジェクトのプロパティでJS APIと急速に同期しなくなるという問題があります。

私がしたいのは、JSDocのコメントから少なくともYAMLのデータ定義部分を自動的に生成することです。それを自動化するのに役立つツールはありますか？

Answer 1

swagger-jsdocがあなたの要件を満たしていることがあります。