edit Tag Object Examples
MODIFY
versions/3.0.md
versions/3.0.md
@@ -2340,15 +2340,15 @@ description: Pets operations
#### <a name="examplesObject"></a>Examples Object
-Anywhere an `example` may be given, a JSON Reference MAY be used, with the
+In an `example`, a JSON Reference MAY be used, with the
explicit restriction that examples having a JSON format with object named
-`$ref` are not allowed. This does mean that `example`, structurally, can be
+`$ref` are not allowed. Therefore, that `example`, structurally, can be
either a string primitive or an object, similar to `additionalProperties`.
In all cases, the payload is expected to be compatible with the type schema
-for the value that it is accompanying. Tooling implementations MAY choose to
+for the associated value. Tooling implementations MAY choose to
validate compatibility automatically, and reject the example value(s) if they
-are not compatible.
+are incompatible.
```yaml
# in a model

edit Tag Object Examples