v3.2: Consider moving guidance on supplying a retrieval URL (and other parts of the spec that justify various features) to the Learn site #4540
Labels
deployment
Servers and related deployment configuration
re-use: ref/id resolution
how $ref, operationId, or anything else is resolved
From @notEthan in PR #4389:
Where "this" means the list of use cases for accepting a user-supplied base URI.
The reason that list is present is that, over the past ten years of dealing with this issue for both JSON Schema and OAS, there is tremendous pushback and lack of understanding if the requirement is given without justification.
We could move all such justification to the Learn site, but for now it is in the spec so that implementors understand why they are being asked to support this.
The text was updated successfully, but these errors were encountered: