Swagger.Next: Forbid properties other than $ref inside JSON Pointer

[IvanGoncharov]

From JSON Reference:

Any members other than "$ref" in a JSON Reference object SHALL be ignored.

Implementations MAY choose to replace the reference with the referenced value.

So technically JSON Reference doesn't forbid this behaviour, but it only makes the situation worse.
Since people expect different behaviour and it split lib/tools into two camps.
Ones who replace the reference and one who iterates through $refs.

@whitlockjc I believe you have some background on this issue.

[IvanGoncharov]

+ it's really easy to implement such check in JSON Schema just add additionalProperties: false

[whitlockjc]

👍

[webron]

This is pretty much the opposite of #556 and honestly I'd rather see #556 implemented than this, for the value it provides. I mean, both this and #556 don't follow the JSON Reference spec as it is (which is fine by me), but if we break away, why not make it more useful?

[webron]

Parent: #579

[IvanGoncharov]

@webron This issue is really different from #556
This issue is compatible with JSON Pointer, OpenAPI is still could be resolved by tools intended for JSON Pointer. It purpose is to make validation sticker to a user from unexpected behavior.
Because properties that would be overridden is never an intended behaviour.

In any case, I think JSON Pointer compatibility is more important than this two issues put together.

[webron]

This issue is incompatible with JSON Pointer because it adds a restriction that JSON Pointer doesn't have. If the JSON Pointer's spec writer wanted to disallow extra properties, they would have used different wording in the spec. I believe the wording there was intentional and we should not ignore it. And considering this feature wants to restrict JSON Pointer more than it is, and #556 calls for the opposite...

[fehguy]

I'm removing the meta issue from this--it's really part of our larger discussion about JSON schema support.

[webron]

Yeah, the Meta Issue tag was by mistake, meant to add the openapi.next.

[webron]

Tackling PR: #741