essentials-openapi
essentials-openapi copied to clipboard
Functions to handle OpenAPI Documentation.
``` ??? note "{{texts.description.title()}}" {{operation.description | wordwrap(76) | indent(4)}} {% endif %} ``` The wordwrap here breaks long links, and mermaid superfences code blocks.
This is valid in OpenAPI v3: ```yaml paths: /collections: get: operationId: getCollections tags: - Collection parameters: - $ref: "./types.yaml#/components/parameters/as" - $ref: "./types.yaml#/components/parameters/page" - $ref: "./types.yaml#/components/parameters/size" - $ref: "./types.yaml#/components/parameters/sort" responses: 200:...
**jsonSchemaDialect** is not required and should not have a default value