From 7eb71ad81fbc5bad6d1a4d4cc8fa4b604b770211 Mon Sep 17 00:00:00 2001
From: "Henry H. Andrews" <andrews_henry@yahoo.com>
Date: Mon, 27 May 2024 15:38:40 -0700
Subject: [PATCH 1/3] Fix confusing usage of "WebHook"

Not only do we not capitalize the "h" elsewhere, this example,
which pre-dated 3.1 webhooks, used the term in a confusinglty
not-quite-the-same way.
---
 versions/3.1.1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/versions/3.1.1.md b/versions/3.1.1.md
index 5563672e57..7ff6dd2497 100644
--- a/versions/3.1.1.md
+++ b/versions/3.1.1.md
@@ -2021,7 +2021,7 @@ $response.header.Location | https://example.org/subscription/1
 
 ##### Callback Object Examples
 
-The following example uses the user provided `queryUrl` query string parameter to define the callback URL.  This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook.
+The following example uses the user provided `queryUrl` query string parameter to define the callback URL.  This is similar to a [`webhooks`](#oasWebhooks), but differs in that the callback only occurs because of the initial request that sent the `queryUrl`.
 
 ```yaml
 myCallback:

From 0c5bd00cb15c13269764cfdc3e1bce05d3d4dcb0 Mon Sep 17 00:00:00 2001
From: "Henry H. Andrews" <andrews_henry@yahoo.com>
Date: Mon, 27 May 2024 15:41:10 -0700
Subject: [PATCH 2/3] Replace deprecated example with examples in schema

3.1 deprecates the OAS extension `example` schema keyword
in favor of the draft 2020-12 `examples` standard schema keyword.
---
 versions/3.1.1.md | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/versions/3.1.1.md b/versions/3.1.1.md
index 7ff6dd2497..9028d2c209 100644
--- a/versions/3.1.1.md
+++ b/versions/3.1.1.md
@@ -2587,10 +2587,12 @@ additionalProperties:
   "required": [
     "name"
   ],
-  "example": {
-    "name": "Puma",
-    "id": 1
-  }
+  "examples": [
+    {
+      "name": "Puma",
+      "id": 1
+    }
+  ]
 }
 ```
 
@@ -2604,8 +2606,8 @@ properties:
     type: string
 required:
 - name
-example:
-  name: Puma
+examples:
+- name: Puma
   id: 1
 ```
 

From 5bbea468793be8d0054d159b4d9c10d6fc2f8b43 Mon Sep 17 00:00:00 2001
From: "Henry H. Andrews" <andrews_henry@yahoo.com>
Date: Tue, 28 May 2024 10:37:02 -0700
Subject: [PATCH 3/3] Fix typos on webook(s) link

---
 versions/3.1.1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/versions/3.1.1.md b/versions/3.1.1.md
index 9028d2c209..c1004d5434 100644
--- a/versions/3.1.1.md
+++ b/versions/3.1.1.md
@@ -2021,7 +2021,7 @@ $response.header.Location | https://example.org/subscription/1
 
 ##### Callback Object Examples
 
-The following example uses the user provided `queryUrl` query string parameter to define the callback URL.  This is similar to a [`webhooks`](#oasWebhooks), but differs in that the callback only occurs because of the initial request that sent the `queryUrl`.
+The following example uses the user provided `queryUrl` query string parameter to define the callback URL.  This is similar to a [webhook](#oasWebhooks), but differs in that the callback only occurs because of the initial request that sent the `queryUrl`.
 
 ```yaml
 myCallback: