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.
Correct syntax of array of strings constrained on enum values (compatible with OAS2.0 and OAS3.x)