Saludos, tengo la duda: ¿En node habrá un paquete que permita documentar las APIS a través de anotaciones en las cabeceras de los métodos...

Si te sirve y te surge alguna duda, no dudes en preguntarme @JDiaz0017 🙂

Buenas, acabo de ver tu comentario, justo comenté hace dos días, que he sacado una librería que te permite documentar tus endpoints de express sin tener que escribir el YAML o JSON. Lo único que tienes que hacer es escribir comentarios en tus endpoints y la interfaz de usuario se generará automáticamente. Te dejo el enlace a la documentación: https://brikev.github.io/express-jsdoc-swagger-docs/#/

Mira: https://itnext.io/setting-up-swagger-in-a-node-js-application-d3c4d7aa56d4.

@juandc pero asi documentaria el codigo fuente, no la api por medio de swagger. Creo que node no tiene una herramienta de autodocumentacion de apis con swagger como si la tiene java con jenkins

Puedes usar JSDoc: https://jsdoc.app/about-getting-started.html.

¡O TypeScript! https://platzi.com/clases/1642-javascript-profesional/22178-introduccion/