From dbba0ba7442f486f993318fbcb9e4ae9d40a06d9 Mon Sep 17 00:00:00 2001
From: "Henry H. Andrews" <andrews_henry@yahoo.com>
Date: Wed, 8 Jan 2025 17:36:20 -0800
Subject: [PATCH 1/2] Fix copy-paste "format: binary" error

These examples got copied from 3.0.4 and apparently I forgot to
adjust them for 3.1.1 and no one else noticed.
---
 src/oas.md | 36 ++++++++++++++++--------------------
 1 file changed, 16 insertions(+), 20 deletions(-)

diff --git a/src/oas.md b/src/oas.md
index 4c89a019ce..fa86d62a4e 100644
--- a/src/oas.md
+++ b/src/oas.md
@@ -1800,17 +1800,17 @@ requestBody:
       schema:
         type: object
         properties:
+          # default for a string without `contentEncoding` is `text/plain`
           id:
-            # default for primitives without a special format is text/plain
             type: string
             format: uuid
-          profileImage:
-            # default for string with binary format is `application/octet-stream`
-            type: string
-            format: binary
+
+          # default for a schema withhout `type` is `application/octet-stream`
+          profileImage: {}
+
+          # default for arrays is based on the type in the `items`
+          # subschema, which is an object, so `application/json`
           addresses:
-            # default for arrays is based on the type in the `items`
-            # subschema, which is an object, so `application/json`
             type: array
             items:
               $ref: '#/components/schemas/Address'
@@ -1828,31 +1828,27 @@ requestBody:
       schema:
         type: object
         properties:
+          # No Encoding Object, so use default `text/plain`
           id:
-            # default is `text/plain`
             type: string
             format: uuid
+
+          # Encoding Object overrides the default `application/json`
+          # for each item in the array with `application/xml; charset=utf-8`
           addresses:
-            # default based on the `items` subschema would be
-            # `application/json`, but we want these address objects
-            # serialized as `application/xml` instead
             description: addresses in XML format
             type: array
             items:
               $ref: '#/components/schemas/Address'
-          profileImage:
-            # default is application/octet-stream, but we can declare
-            # a more specific image type or types
-            type: string
-            format: binary
+
+          # Encoding Object accepts only PNG or JPEG, and also describes
+          # a custom header for just this part in the multipart format
+          profileImage: {}
+
       encoding:
         addresses:
-          # require XML Content-Type in utf-8 encoding
-          # This is applied to each address part corresponding
-          # to each address in he array
           contentType: application/xml; charset=utf-8
         profileImage:
-          # only accept png or jpeg
           contentType: image/png, image/jpeg
           headers:
             X-Rate-Limit-Limit:

From f48940caddb738ddc134cb0c849caae0bc910a0a Mon Sep 17 00:00:00 2001
From: Ralf Handl <ralf.handl@sap.com>
Date: Fri, 10 Jan 2025 15:49:38 +0100
Subject: [PATCH 2/2] Typo

---
 src/oas.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/oas.md b/src/oas.md
index fa86d62a4e..3a00b8cf96 100644
--- a/src/oas.md
+++ b/src/oas.md
@@ -1805,7 +1805,7 @@ requestBody:
             type: string
             format: uuid
 
-          # default for a schema withhout `type` is `application/octet-stream`
+          # default for a schema without `type` is `application/octet-stream`
           profileImage: {}
 
           # default for arrays is based on the type in the `items`