Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
fix description for parameters in OpenAPI 3 #223
In OpenAPI3, desired output for query parameters is like this:
parameters: - description: Password in: query name: password required: true schema: type: string
However, only properties in, name and required are defined in the top level, while all other properties is moved under property schema, which conflicts with OpenAPI 3 specification.
parameters: - in: query name: password required: true schema: type: string description: Password
So before moving all properties to schema, it's reasonable to check for description property and define description in top level of parameter object.