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.
Posted the issue on apidoc too but is there a way to define a param as a query param rather than a path?
By default any params seem to get set to be a path in apidoc.