APIs should declare an OpenAPI Overlay so consumers can discover documented, reusable modifications applied to the API's OpenAPI definition. Declaring a property of type OpenAPIOverlay in the APIs.json properties array publishes this artifact as part of the API's discoverable index.
APIs.json Overlay Info
Message: Declares an OpenAPI Overlay.
Policies
OpenAPI Overlays Used
Require that consistent, cross-cutting changes to OpenAPI definitions be applied through OpenAPI Overlays rather than by hand-editing each specification. I want shared conventions, added examples, ...
