Ron

PRs welcome.

It's not currently supported by the spec, and @cebe's example is unfortunately invalid.

We try to be specific about what can be referenced as (especially now), we now include anything that can be referenced under `components` as reusable items. Individual operations don't tend...

The reuse of Path Item Object was introduced a while back, and taking it out now is a bit of a challenge. I was surprised to see it being used,...

@jdesrosiers it's an old remnant of version 2.0, where we allowed the reference without knowing back then that it cannot live alongside other properties. So back then (and now), it...

Sure, thanks for bringing that up. Somewhat reminds me of a SOAP envelope (in concept, not meaning). To help us better assess this, can you provide more details on what...

Why would it violate the REUSE guidelines? JSON Schema allows you to define conflicting schema under `allOf`. It's useless, but it doesn't violate it. However, if we're looking to make...

`allOf` is does not merge objects. `allOf` means that a given value is validated against all-of the listed schema, one by one. So yeah, they can be conflicting and not...

You've left out a bunch of details from the table - please fill them in. We also need a full API definition - we can't really test the issue with...

What would you hope to see there?