|
1 |
| -# Overlay-Specification |
| 1 | +# Overlay Specification |
2 | 2 |
|
3 | 3 | The Overlay Specification is a community-driven open specification within the [OpenAPI Initiative](https://www.openapis.org/), a Linux Foundation Collaborative Project.
|
4 | 4 |
|
5 |
| -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. |
| 5 | +The Overlay Specification provides a way to augment an existing OpenAPI description without modifying the source document. |
6 | 6 |
|
7 |
| -Overlays can address a wide range of scenarios that have been frequently requested by OpenAPI users: |
| 7 | +Overlays support a wide range of scenarios: |
8 | 8 |
|
9 |
| -- Support multi-language API descriptions by using Overlays to contain language translations. |
10 |
| -- Provide configuration information for different deployment environments. |
11 |
| -- Allow separation of concerns for metadata such as gateway configuration or SLA information. |
12 |
| -- Support a traits like capability for applying a set of configuration data, such as multiple parameters, or multiple headers to a targeted object. |
13 |
| -- Provide default responses, or parameters where they are not explicitly provided. |
14 |
| -- Apply configuration data globally or based on filter conditions. |
| 9 | +- Translating documentation into another language. |
| 10 | +- Providing configuration information for different deployment environments. |
| 11 | +- Allowing separation of concerns for metadata such as gateway configuration or SLA information. |
| 12 | +- Supporting a traits-like capability for applying a set of configuration data, such as multiple parameters or multiple headers, for a targeted object. |
| 13 | +- Providing default responses or parameters where they are not explicitly provided |
| 14 | +- Appling configuration data globally or based on filter conditions |
15 | 15 |
|
16 | 16 | ## Current Status
|
17 | 17 |
|
18 |
| -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. |
| 18 | +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. |
19 | 19 |
|
20 | 20 | ## Tools that support Overlays
|
21 | 21 |
|
|
0 commit comments