Expanded representations examples

Author: darrelmiller

versions/3.0.md

@@ -840,7 +840,7 @@ representations:
 
 #### <a name="representationsObject"></a>Representations Object
 
-Describes a set of supported representations.  A representations object can be used in [requestBody](#requestBody), [response objects](#responseObject) and [parameter objects](#parameterObject) to describe complex parameters.
+Describes a set of supported representations.  A representations object can be used in [requestBody](#requestBody) and [response objects](#responseObject).
 
 Each key in the representations object is the media-type of the [Representation Object](#representationObject).
 
@@ -849,15 +849,29 @@ Each key in the representations object is the media-type of the [Representation
 ```js
 "representations" : {
   "application/json": {
+   'application/json':
+
     "schema": {
       "type": "array",
       "items": {
         "type": "string"
       }
     },
-    "examples": []
+    "examples": [
+      ["Bob","Diane","Mary","Bill"],
+      []
+     ]
   },
-  "application/xml" : {}
+  "application/xml" : {
+    "examples" : [
+      "<Users><User name='Bob'/><User name='Diane'/><User name='Mary'/><User name='Bill'/></Users>",
+      "<Users/>"
+    ]
+  },
+  "text/plain" : {
+    "Bob,Diane,Mary,Bill",
+    ""
+  }
 }
 ```
 
@@ -868,7 +882,21 @@ representations:
       type: array
       items:
         type: string
-  'application/xml': {}
+    examples:
+      - 
+        - Bob
+        - Diane
+        - Mary
+        - Bill
+      - {}
+
+  'application/xml': 
+    examples:
+      - "<Users><User name='Bob'/><User name='Diane'/><User name='Mary'/><User name='Bill'/></Users>"
+      - "<Users/>"
+  'text/plain':
+    examples:
+      - "Bob,Diane,Mary,Bill"
 ```
 
 #### <a name="representationObject"></a>Representation Object