Merge pull request OAI#1183 from krishahn/example-object

edit Example Object

Author: Ron

versions/3.0.md

@@ -1804,15 +1804,14 @@ Field Name | Type | Description
 ---|:---:|---
 <a name="exampleSummary"></a>summary | `string` | Short description for the example.
 <a name="exampleDescription"></a>description | `string` | Long description for the example. [CommonMark syntax](http://spec.commonmark.org/) can be used for rich text representation.
-<a name="exampleValue"></a>value | Any | Embedded literal example. The `value` field and `externalValue` field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
-<a name="exampleExternalValue"></a>externalValue | `string` | A URL that points to the literal example. This provides the ability to reference examples that cannot easily be included in JSON or YAML documents.  The `value` field and `externalValue` field are mutually exclusive. 
+<a name="exampleValue"></a>value | Any | Embedded literal example. The `value` field and `externalValue` field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
+<a name="exampleExternalValue"></a>externalValue | `string` | A URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents.  The `value` field and `externalValue` field are mutually exclusive. 
 
 This object can be extended with [Specification Extensions](#specificationExtensions). 
 
 In all cases, the example value is expected to be compatible with the type schema 
-for the value that it is accompanying.  Tooling implementations MAY choose to 
-validate compatibility automatically, and reject the example value(s) if they 
-are not compatible.
+of its associated value.  Tooling implementations MAY choose to 
+validate compatibility automatically, and reject the example value(s) if incompatible.
 
 ##### Example Object Example