Render x-enumDescriptions in table

[omonk]

Description

This PR adds the ability to render x-enumDescription values alongside enum lists

Motivation and Context

I am working on a spec with ~100 uses of x-enumDescription, a feature of redocly. We have just migrated from redocly and would rather not require reformatting my spec to.

How Has This Been Tested?

See new entries to parameters and response body in the petstore yaml

Screenshots (if appropriate)

Response body

Parameter

Types of changes

• New feature (non-breaking change which adds functionality)

Checklist

• [ x ] I have updated the documentation accordingly.
• [ x ] I have read the CONTRIBUTING document.
• [ x ] I have added tests to cover my changes if appropriate.
• [ x ] All new and existing tests passed.

[github-actions]

Visit the preview URL for this PR (updated for commit d0b5160):

https://docusaurus-openapi-36b86--pr951-0d07hg1l.web.app

_{(expires Thu, 10 Oct 2024 12:18:33 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: bf293780ee827f578864d92193b8c2866acd459f}

[sserrata]

Thanks for the PR @omonk - made me realize we should probably try to document the vendor extensions supported by the plugin.

[sserrata]

Yeah, it's on the roadmap to tackle param serialization styles, but this should be ok for now.

[sserrata]

Small request - can we rename "Enum" to "Enum Value" for clarity/consistency? Thanks!

[omonk]

Small request - can we rename "Enum" to "Enum Value" for clarity/consistency? Thanks!

Ah yes, resolved this now, thanks @sserrata

[omonk]

Many thanks @sserrata - what are you plans with the next release?

[sserrata]

Many thanks @sserrata - what are you plans with the next release?

Hopefully by end of week. Reminder that canary releases are published with each merge to main.