Skip to content

Commit 78e3a3d

Browse files
committed
Minor nits
1 parent 8e65fcf commit 78e3a3d

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

versions/1.0.0.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ In order to preserve the ability to round-trip between YAML and JSON formats, [[
4444

4545
### Document Structure
4646

47-
It is RECOMMENDED that the root Overlay document be named: `overlay.json` or `overlay.yaml`.
47+
It is RECOMMENDED that an Overlay document be named: `overlay.json` or `overlay.yaml`.
4848

4949
### Relative References in URLs
5050

@@ -70,9 +70,9 @@ This is the root object of the [Overlay](#overlay).
7070

7171
This object MAY be extended with [Specification Extensions](#specification-extensions).
7272

73-
The list of actions MUST be applied in sequential order to ensure a consistent outcome. Actions are applied to the result of the previous updates. This enables objects to be deleted in one update and then re-created in a subsequent update, for example.
73+
The list of actions MUST be applied in sequential order to ensure a consistent outcome. Actions are applied to the result of the previous action. This enables objects to be deleted in one action and then re-created in a subsequent action, for example.
7474

75-
The `extends` property can be used to indicate that the Overlay was designed to update a specific [[OpenAPI]] document. Where no `extends` is provided it is the responsibility of tooling to apply the Overlay documents to the appropriate OpenAPI document(s).
75+
The `extends` property can be used to indicate that the Overlay was designed to update a specific [[OpenAPI]] document. Where no `extends` is provided it is the responsibility of tooling to apply the Overlay document to the appropriate OpenAPI document(s).
7676

7777
#### Info Object
7878

@@ -107,7 +107,7 @@ To update a primitive property value such as a string, the `target` expression s
107107

108108
Primitive-valued items of an array cannot be replaced or removed individually, only the complete array can be replaced.
109109

110-
The properties of the update object MUST be compatible with the target object referenced by the JSONPath key. When the Overlay document is applied, the properties in the merge object replace properties in the target object with the same name and new properties are appended to the target object.
110+
The properties of the `update` object MUST be compatible with the target object referenced by the JSONPath key. When the Overlay document is applied, the properties in the `update` object replace properties in the target object with the same name and new properties are appended to the target object.
111111

112112
This object MAY be extended with [Specification Extensions](#specification-extensions).
113113

0 commit comments

Comments
 (0)