Describe the bug
As mentioned in #410 (comment), when using this plugin with an OpenAPI 3.1 schema that uses [string, null] as a list of valid types for a property, instead of showing the enum of types, it joins the array together with no spaces.
Expected behavior
Show a "nullable" tag for the property or just list the valid property types.
For example of the usage, see https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0 and "Swap nullable for type arrays"
Another example of this valid usage in OpenAPI 3.1: OAI/OpenAPI-Specification#3148
Current behavior
The list of valid property types are joined into a string with no spaces.
Possible solution
Steps to reproduce
- Create an OpenAPI 3.1 schema that has a property with type
[string, null]
- Render API docs with the plugin
Screenshots
Context
Trying to keep up-to-date with the current OpenAPI schema while providing clear, useful, and accurate api docs to our users.
Your Environment
Describe the bug
As mentioned in #410 (comment), when using this plugin with an OpenAPI 3.1 schema that uses
[string, null]as a list of valid types for a property, instead of showing the enum of types, it joins the array together with no spaces.Expected behavior
Show a "nullable" tag for the property or just list the valid property types.
For example of the usage, see https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0 and "Swap nullable for type arrays"
Another example of this valid usage in OpenAPI 3.1: OAI/OpenAPI-Specification#3148
Current behavior
The list of valid property types are joined into a string with no spaces.
Possible solution
Steps to reproduce
[string, null]Screenshots
Context
Trying to keep up-to-date with the current OpenAPI schema while providing clear, useful, and accurate api docs to our users.
Your Environment