Use `example` value instead of `default`

[OzzyCzech]

Is your feature request related to a problem?

There should be switch or something in config that allow us use example value instead of default or primitives in Example (from schema).

I've been looking at the code, there is TODO 😄

docusaurus-openapi-docs/packages/docusaurus-plugin-openapi-docs/src/openapi/createResponseExample.ts

Lines 83 to 86 in becd0ae

	// TODO: determine if we should always ignore the example when creating from schema
	// if (example !== undefined) {
	// return example;
	// }

Describe the solution you'd like

Would be nice use example when it's set or let developer chose what's they want.

Additional context

Let's check Swagger, they also use example values in example json Responses instead of string

[sserrata]

Hi @OzzyCzech, thanks for reporting this issue. Can you share your OpenAPI spec or a snippet corresponding to the screenshot you provided?

[OzzyCzech]

Sure @sserrata here is my project https://github.com/testomato/help.testomato.com/ and mine OpenAPI yaml file

[sserrata]

Thanks! I just tested locally (after uncommenting the lines you cited) and got the following:

Is that what you would expect?

[OzzyCzech]

Yes, that's what should be there

[sserrata]

Thanks. I believe it's safe to merge the change but I'd like to do a bit more testing before releasing in production, just to make sure. That said, I'll ping you when a canary release is available to test with.

[OzzyCzech]

Sure, thank you very much.

[sserrata]

Here's the canary release if you'd like to preview/test the change: 0.0.0-480