Ask HN: Node.js API Documentation
4 comments
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.
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...
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
[2]: https://github.com/dsherret/ts-morph
[3]: https://github.com/Eywek/oatyp
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
[2]: https://github.com/dsherret/ts-morph
[3]: https://github.com/Eywek/oatyp
Second this, it's a great piece of work.
In the dotnet world there is swashbuckle. Is there a node equivalent or better?