2015-09-24 14 views
7

Mam duże JS API w pełni udokumentowane za pomocą JSDoc, a ja buduję usługę REST opartą na swagge, aby API było dostępne w sieci.Generowanie Swagger YAML z JSDoc?

Ręcznie stworzyłem wstępną wersję specyfikacji Swamera YAML, ale problem polega na tym, że szybko traci synchronizację z interfejsem API JS, ponieważ wciąż ewoluuje, szczególnie we właściwościach obiektów.

Co chciałbym zrobić, to automatycznie wygenerować YAML-swagger, przynajmniej część definicji danych, bezpośrednio z komentarzy JSDoc. Czy jest jakieś narzędzie, które pomoże mi je zautomatyzować?

Odpowiedz