Clarification of OpenAPI 3 known issues

[tamlyn]

The discriminator support in the inheritance chain stops when getting to a child without a discriminator (a leaf in the inheritance tree), meaning a child without a discriminator cannot point to another child with a discriminator.

Is the implication of this that the provided discriminator-on-child example will not work under OpenAPI 3?

[kobik]

@tamlyn yes, i believe so.

it's a limitation of api-shcema-builder we rely on when parsing definitions file and should be addressed there.

[tamlyn]

Thanks. I didn't understand what that meant until I came across the problem myself. It's annoying to discover this limitation only after investing several days of effort into it.

I'm going to leave this open a bit longer in the hope that it will encourage me to submit a PR that clarifies the wording.

[kobik]

@tamlyn, now you made me waiting for your PR 🙂