Merge pull request #1191 from krishahn/tag-object-examples

edit Tag Object Examples

Author: Ron

versions/3.0.md

@@ -2338,15 +2338,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