Ron

@darrelmiller - what @tedepstein summarized is pretty much the spirit of what we intended in 2.0, and have hopefully managed to capture in the changes to 3.0. As for the...

As @tedepstein said, `$ref`s can point anywhere. The only thing that's required by the spec is that the target of the reference is a valid object that 'fits' into that...

That's a fair question and needs to be clarified. The 'basic' limitation would be within the same Swagger description. The real challenge is how it would behave when referencing external...

I believe this is covered by 3.0 now. If not, please reopen.

Yup, it was never implemented that way. PRs are welcome.

Thanks for the report, @naesean. You're correct in saying it's not rendered. This was an addition in OpenAPI 3.0, but it's one that doesn't really work well with how Swagger...

Unlikely to happen, though we may consider it. Tags are intended for grouping of operations, not filters.