chore: improve Event property

[jbergstroem]

• merge anyOf and properties for the Event schema
• add a maxItems to auctions array and use discriminator to explain the type relationship
• CategoryDisjunctions incorrectly refers to minimum instead of minLength

Closes: #186

[jbergstroem]

I looked at a preview of the documentation and the anyOf properties where not displayed correctly. How can we test it looks ok?

Right now its painful to test, but the most straightforward solution is to have the mintlify-docs repo running locally, copy over the yaml into the docs repo which has a process to merge documents, then review it in the live dev environment.

You can also test via another tool such as scalar, but there's no guarantee they will render it the same way: https://docs.scalar.com/editor#/reference

[sk-]

Could we also fix the warnings in another PR?

[jbergstroem]

Could we also fix the warnings in another PR?

yeah i have a draft branch that takes a pass at many warnings

[jilanglois]

Looks good! My only concern is that a user looking at the docs understands that they can send more than one option at a time. I believe some of the examples do show this use case so it might be fine.

[sk-]

Left some comments about unused objects.

Could you also update the PR description to reflect the current changes.