From b7a2d9ff22020920086495400997f9b5b1b93b02 Mon Sep 17 00:00:00 2001
From: Ralf Handl <ralf.handl@gmail.com>
Date: Wed, 26 Mar 2025 14:58:02 +0100
Subject: [PATCH] fixes #3538

---
 src/oas.md                         | 2 +-
 src/schemas/validation/schema.yaml | 2 --
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/oas.md b/src/oas.md
index 400813a449..4be888a19f 100644
--- a/src/oas.md
+++ b/src/oas.md
@@ -2008,7 +2008,7 @@ Describes a single response from an API operation, including design-time, static
 
 | Field Name | Type | Description |
 | ---- | :----: | ---- |
-| <a name="response-description"></a>description | `string` | **REQUIRED**. A description of the response. [CommonMark syntax](https://spec.commonmark.org/) MAY be used for rich text representation. |
+| <a name="response-description"></a>description | `string` | A description of the response. [CommonMark syntax](https://spec.commonmark.org/) MAY be used for rich text representation. |
 | <a name="response-headers"></a>headers | Map[`string`, [Header Object](#header-object) \| [Reference Object](#reference-object)] | Maps a header name to its definition. [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.1) states header names are case insensitive. If a response header is defined with the name `"Content-Type"`, it SHALL be ignored. |
 | <a name="response-content"></a>content | Map[`string`, [Media Type Object](#media-type-object)] | A map containing descriptions of potential response payloads. The key is a media type or [media type range](https://www.rfc-editor.org/rfc/rfc9110.html#appendix-A) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. `"text/plain"` overrides `"text/*"` |
 | <a name="response-links"></a>links | Map[`string`, [Link Object](#link-object) \| [Reference Object](#reference-object)] | A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for [Component Objects](#components-object). |
diff --git a/src/schemas/validation/schema.yaml b/src/schemas/validation/schema.yaml
index 947a4b004b..2ea743dd49 100644
--- a/src/schemas/validation/schema.yaml
+++ b/src/schemas/validation/schema.yaml
@@ -555,8 +555,6 @@ $defs:
         type: object
         additionalProperties:
           $ref: '#/$defs/link-or-reference'
-    required:
-      - description
     $ref: '#/$defs/specification-extensions'
     unevaluatedProperties: false