You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: versions/1.0.0.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -44,7 +44,7 @@ In order to preserve the ability to round-trip between YAML and JSON formats, [[
44
44
45
45
### Document Structure
46
46
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`.
48
48
49
49
### Relative References in URLs
50
50
@@ -70,9 +70,9 @@ This is the root object of the [Overlay](#overlay).
70
70
71
71
This object MAY be extended with [Specification Extensions](#specification-extensions).
72
72
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.
74
74
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).
76
76
77
77
#### Info Object
78
78
@@ -107,7 +107,7 @@ To update a primitive property value such as a string, the `target` expression s
107
107
108
108
Primitive-valued items of an array cannot be replaced or removed individually, only the complete array can be replaced.
109
109
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.
111
111
112
112
This object MAY be extended with [Specification Extensions](#specification-extensions).
0 commit comments