Ask HN: Node.js API Documentation
What do you use to get a swagger.json or similar for api documentation?
In the dotnet world there is swashbuckle. Is there a node equivalent or better? I have been using tsoa to generate API documentation from TypeScript types.
https://github.com/lukeautry/tsoa Example project: https://github.com/RaedsLab/demo-project/blob/master/backend... We used tsoa where i work but had issues with complex types [0] so one of our dev rewrote a simpler implementation [1] that use ts-morph [2] under the hood. Not exactly related but we had issues with the official openapi generated so he also wrote a package to codegen typescript client from an openapi file [3] [0]: https://github.com/lukeautry/tsoa/pulls?q=is%3Apr+sort%3Aupd... [1]: https://github.com/Eywek/typoa Second this, it's a great piece of work. I think the official swagger-node (https://github.com/swagger-api/swagger-node) hasn't been updated for a while. There is swagger-jsdoc (https://www.npmjs.com/package/swagger-jsdoc) though.