Skip to content

Commit 2875dcb

Browse files
authored
Wordsmithing the readme
for your consideration
1 parent d029f0d commit 2875dcb

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

README.md

+10-10
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
1-
# Overlay-Specification
1+
# Overlay Specification
22

33
The Overlay Specification is a community-driven open specification within the [OpenAPI Initiative](https://www.openapis.org/), a Linux Foundation Collaborative Project.
44

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.
66

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:
88

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
1515

1616
## Current Status
1717

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.
1919

2020
## Tools that support Overlays
2121

0 commit comments

Comments
 (0)