From 23551850ce216711bcbc407108a00e2a488004d2 Mon Sep 17 00:00:00 2001
From: Travis Prescott <trpresco@microsoft.com>
Date: Fri, 25 Aug 2023 14:18:31 -0700
Subject: [PATCH] Fixes #2238.

---
 .../@typespec/http/bodyTDoc_2023-08-25-21-19.json      | 10 ++++++++++
 .../@typespec/openapi3/bodyTDoc_2023-08-28-15-54.json  | 10 ++++++++++
 packages/http/lib/http.tsp                             |  1 +
 packages/openapi3/test/metadata.test.ts                |  1 +
 4 files changed, 22 insertions(+)
 create mode 100644 common/changes/@typespec/http/bodyTDoc_2023-08-25-21-19.json
 create mode 100644 common/changes/@typespec/openapi3/bodyTDoc_2023-08-28-15-54.json

diff --git a/common/changes/@typespec/http/bodyTDoc_2023-08-25-21-19.json b/common/changes/@typespec/http/bodyTDoc_2023-08-25-21-19.json
new file mode 100644
index 00000000000..e59b9bb12e2
--- /dev/null
+++ b/common/changes/@typespec/http/bodyTDoc_2023-08-25-21-19.json
@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/http",
+      "comment": "",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/http"
+}
\ No newline at end of file
diff --git a/common/changes/@typespec/openapi3/bodyTDoc_2023-08-28-15-54.json b/common/changes/@typespec/openapi3/bodyTDoc_2023-08-28-15-54.json
new file mode 100644
index 00000000000..d9a70151de5
--- /dev/null
+++ b/common/changes/@typespec/openapi3/bodyTDoc_2023-08-28-15-54.json
@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/openapi3",
+      "comment": "",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/openapi3"
+}
\ No newline at end of file
diff --git a/packages/http/lib/http.tsp b/packages/http/lib/http.tsp
index b78c4a31bd5..5ed6a239fb9 100644
--- a/packages/http/lib/http.tsp
+++ b/packages/http/lib/http.tsp
@@ -29,6 +29,7 @@ model Response<Status> {
 @doc("")
 model Body<T> {
   @body
+  @doc("The body type of the operation request or response.")
   body: T;
 }
 
diff --git a/packages/openapi3/test/metadata.test.ts b/packages/openapi3/test/metadata.test.ts
index 2f764e0c846..3cccf29bc60 100644
--- a/packages/openapi3/test/metadata.test.ts
+++ b/packages/openapi3/test/metadata.test.ts
@@ -517,6 +517,7 @@ describe("openapi3: metadata", () => {
             },
           },
           requestBody: {
+            description: "The body type of the operation request or response.",
             required: true,
             content: {
               "application/json": {