7
Ich habe eine große JS-API, die vollständig mit JSDoc dokumentiert ist, und ich baue einen Swagger-basierten REST-Dienst, um die API in einem Netzwerk verfügbar zu machen.Generieren Swagger YAML von JSDoc?
Ich habe eine erste Version der YAML-Swagger-Spezifikation manuell erstellt, aber das Problem ist, dass sie schnell mit der JS-API nicht mehr synchron ist, da sie sich gerade in den Eigenschaften der beteiligten Objekte weiterentwickelt.
Was ich tun möchte, ist die automatische Generierung des Swagger YAML, zumindest der Datendefinitionsteil, direkt aus den JSDoc-Kommentaren. Gibt es ein Tool, mit dem ich es automatisieren kann?