Feedback from mkistler about contentEncoding

Author: handrews

src/oas.md

@@ -2139,8 +2139,9 @@ requestBody:
           name:
             type: string
           icon:
-            # The default with "contentEncoding" is application/octet-stream,
-            # so we need to set image media type(s) in the Encoding Object.
+            # The default content type with "contentEncoding" present
+            # is application/octet-stream, # so we need to set the correct
+            # image media type(s) in the Encoding Object.
             type: string
             contentEncoding: base64url
   encoding:
@@ -2186,17 +2187,21 @@ requestBody:
       schema:
         type: object
         properties:
-          # default for a string without `contentEncoding` is `text/plain`
+          # default content type for a string without `contentEncoding`
+          # is `text/plain`
           id:
             type: string
             format: uuid
 
-          # default for a schema without `type` is `application/octet-stream`
+          # default content type for a schema without `type`
+          # is `application/octet-stream`
           profileImage: {}
 
-          # for arrays, the Encoding Object applies to each item
-          # individually based on that item's type, which in this
-          # example is an object, so `application/json`
+          # for arrays, the `encoding` field applies the Encoding Object
+          # to each item individually and determines the default content type
+          # based on the type in the `items` subschema, which in this example
+          # is an object, so the default content type for each item is
+          # `application/json`
           addresses:
             type: array
             items:
@@ -2220,7 +2225,7 @@ requestBody:
             type: string
             format: uuid
 
-          # Encoding Object overrides the default `application/json`
+          # Encoding Object overrides the default `application/json` content type
           # for each item in the array with `application/xml; charset=utf-8`
           addresses:
             description: addresses in XML format