apidoc and swagger are two nice projects which are focusing on documentation of APIs. This project is a middle tier which tries to bring them together in a sense that it uses apidoc to convert inline documentation to json schema and later convert it to swagger json schmea.
Hi @fsbahman, thanks so much for this module. It just saved a lot time.
I had manually correct some data types, tho https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#dataTypeFormat
Eg. apidoc-swagger output
valid OpenAPI data type and format
It would be great to fix this. If I manage to have some time to work on this I'll make a PR. Opening the issue for now.