Updating representation example

Author: darrelmiller

versions/3.0.md

@@ -337,8 +337,8 @@ A Path Item may be empty, due to [ACL constraints](#securityFiltering). The path
 Field Name | Type | Description
 ---|:---:|---
 <a name="pathItemRef"></a>$ref | `string` | Allows for an external definition of this path item. The referenced structure MUST be in the format of a [Path Item Object](#pathItemObject). If there are conflicts between the referenced definition and this Path Item's definition, the behavior is *undefined*.
-<a name="pathItemSummary"></a>summary | An optional, string summary, intended to apply to all operations in this path.
-<a name="pathItemDescription"></a>description | An optional, string description, intended to apply to all operations in this path.
+<a name="pathItemSummary"></a>summary| `string` | An optional, string summary, intended to apply to all operations in this path.
+<a name="pathItemDescription"></a>description | `string` | An optional, string description, intended to apply to all operations in this path.
 <a name="pathItemGet"></a>get | [Operation Object](#operationObject) | A definition of a GET operation on this path.
 <a name="pathItemPut"></a>put | [Operation Object](#operationObject) | A definition of a PUT operation on this path.
 <a name="pathItemPost"></a>post | [Operation Object](#operationObject) | A definition of a POST operation on this path.
@@ -754,7 +754,6 @@ Field Name | Type | Description
 ---|:---:|---
 <a name="requestBodyDescription"></a>description | `string` | A brief description of the request body. This could contain examples of use.  [GFM syntax](https://help.github.com/articles/github-flavored-markdown) can be used for rich text representation.
 <a name="requestBodyRepresentations"></a>representations | [Representations Object](#representationsObject) | The representations of the request body.
-<a name="requestBodySchema"></a>schema | [Schema Object](#schemaObject) | The schema defining the type used for the request body.
 <a name="requestBodyRequired"></a>required | `boolean` | Determines if the request body is required in the request. Defaults to `true`.
 
 
@@ -849,8 +848,6 @@ Each key in the representations object is the media-type of the [Representation
 ```js
 "representations" : {
   "application/json": {
-   'application/json':
-
     "schema": {
       "type": "array",
       "items": {
@@ -920,24 +917,30 @@ A representation description.
 {
   "application/json": {
     "schema": {
-      "type": "object",
-      "properties": {
-        "type": "string"
-      }
+         "$ref": "#/definitions/Pet"
     },
-    "examples": []
-  },
-  "application/xml" : {}
+    "examples": [{
+                  "name" : "Fluffy",
+                  "petType" : "Cat"
+                 },
+                 { 
+                   "name" : "Rover",
+                   "petType" : "Frog"
+                 }]
+  }
 }
 ```
 
 ```yaml
 application/json: 
   schema:
-    type: array
-    items:
-      type: string
-application/xml: {}
+    $ref: "#/definitions/Pet"
+  examples:
+    - name: Fluffy
+      petType: Cat
+    - name: Rover
+      petType: Frog
+
 ```