The Overlay Specification is a community-driven open specification within the OpenAPI Initiative, a Linux Foundation Collaborative Project.
The Overlay specification defines a way of creating documents that contain information to be merged with an OpenAPI description at some later point in time, for the purpose of updating the OpenAPI description with additional information.
Overlays can address a wide range of scenarios that have been frequently requested by OpenAPI users:
The current specification is sufficiently stable for implementers to start experimenting. We are looking for implementation experience to guide our decisions on the remaining open issues.
If you are looking for tools to use with Overlays, try these:
(Is something missing from the list? Send us a pull request to add it!)
See: License (Apache-2.0)