Update OpenAPI Descriptions (#18613)

* Update OpenAPI Descriptions

* Add decorated OpenAPI schema files

Co-authored-by: github-openapi-bot <github-openapi-bot@users.noreply.github.com>
Co-authored-by: Shati Patel <42641846+shati-patel@users.noreply.github.com>
Co-authored-by: jmarlena <6732600+jmarlena@users.noreply.github.com>

Author: 3 people

lib/rest/static/decorated/api.github.com.json

@@ -30805,7 +30805,7 @@
       }
     ],
     "summary": "List pull requests associated with a commit",
-    "description": "Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.18/rest/reference/pulls#list-pull-requests) endpoint.",
+    "description": "Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.18/rest/reference/pulls#list-pull-requests) endpoint.",
     "tags": [
       "repos"
     ],
@@ -30835,7 +30835,7 @@
     "subcategoryLabel": "Commits",
     "notes": [],
     "bodyParameters": [],
-    "descriptionHTML": "<p>Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.18/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
+    "descriptionHTML": "<p>Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.18/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
     "responses": [
       {
         "httpStatusCode": "200",

lib/rest/static/decorated/ghes-2.18.json

@@ -31372,7 +31372,7 @@
       }
     ],
     "summary": "List pull requests associated with a commit",
-    "description": "Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.19/rest/reference/pulls#list-pull-requests) endpoint.",
+    "description": "Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.19/rest/reference/pulls#list-pull-requests) endpoint.",
     "tags": [
       "repos"
     ],
@@ -31402,7 +31402,7 @@
     "subcategoryLabel": "Commits",
     "notes": [],
     "bodyParameters": [],
-    "descriptionHTML": "<p>Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.19/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
+    "descriptionHTML": "<p>Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.19/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
     "responses": [
       {
         "httpStatusCode": "200",

lib/rest/static/decorated/ghes-2.19.json

@@ -31846,7 +31846,7 @@
       }
     ],
     "summary": "List pull requests associated with a commit",
-    "description": "Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.20/rest/reference/pulls#list-pull-requests) endpoint.",
+    "description": "Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.20/rest/reference/pulls#list-pull-requests) endpoint.",
     "tags": [
       "repos"
     ],
@@ -31876,7 +31876,7 @@
     "subcategoryLabel": "Commits",
     "notes": [],
     "bodyParameters": [],
-    "descriptionHTML": "<p>Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.20/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
+    "descriptionHTML": "<p>Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.20/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
     "responses": [
       {
         "httpStatusCode": "200",

lib/rest/static/decorated/ghes-2.20.json

@@ -35397,7 +35397,7 @@
       }
     ],
     "summary": "List pull requests associated with a commit",
-    "description": "Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.21/rest/reference/pulls#list-pull-requests) endpoint.",
+    "description": "Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.21/rest/reference/pulls#list-pull-requests) endpoint.",
     "tags": [
       "repos"
     ],
@@ -35427,7 +35427,7 @@
     "subcategoryLabel": "Commits",
     "notes": [],
     "bodyParameters": [],
-    "descriptionHTML": "<p>Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.21/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
+    "descriptionHTML": "<p>Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.21/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
     "responses": [
       {
         "httpStatusCode": "200",

lib/rest/static/decorated/ghes-2.21.json

@@ -43196,7 +43196,7 @@
       }
     ],
     "summary": "List pull requests associated with a commit",
-    "description": "Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.22/rest/reference/pulls#list-pull-requests) endpoint.",
+    "description": "Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@2.22/rest/reference/pulls#list-pull-requests) endpoint.",
     "tags": [
       "repos"
     ],
@@ -43226,7 +43226,7 @@
     "subcategoryLabel": "Commits",
     "notes": [],
     "bodyParameters": [],
-    "descriptionHTML": "<p>Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.22/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
+    "descriptionHTML": "<p>Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@2.22/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
     "responses": [
       {
         "httpStatusCode": "200",

lib/rest/static/decorated/ghes-2.22.json

@@ -47648,7 +47648,7 @@
       }
     ],
     "summary": "List pull requests associated with a commit",
-    "description": "Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@3.0/rest/reference/pulls#list-pull-requests) endpoint.",
+    "description": "Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/enterprise-server@3.0/rest/reference/pulls#list-pull-requests) endpoint.",
     "tags": [
       "repos"
     ],
@@ -47678,7 +47678,7 @@
     "subcategoryLabel": "Commits",
     "notes": [],
     "bodyParameters": [],
-    "descriptionHTML": "<p>Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@3.0/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
+    "descriptionHTML": "<p>Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/enterprise-server@3.0/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
     "responses": [
       {
         "httpStatusCode": "200",

lib/rest/static/decorated/ghes-3.0.json

@@ -41658,7 +41658,7 @@
       }
     ],
     "summary": "List pull requests associated with a commit",
-    "description": "Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/github-ae@latest/rest/reference/pulls#list-pull-requests) endpoint.",
+    "description": "Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the [List pull requests](https://docs.github.com/github-ae@latest/rest/reference/pulls#list-pull-requests) endpoint.",
     "tags": [
       "repos"
     ],
@@ -41688,7 +41688,7 @@
     "subcategoryLabel": "Commits",
     "notes": [],
     "bodyParameters": [],
-    "descriptionHTML": "<p>Lists all pull requests containing the provided commit SHA, which can be from any point in the commit history. The results will include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/github-ae@latest/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
+    "descriptionHTML": "<p>Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open pull requests associated with the commit. The results may include open and closed pull requests. Additional preview headers may be required to see certain details for associated pull requests, such as whether a pull request is in a draft state. For more information about previews that might affect this endpoint, see the <a href=\"https://docs.github.com/github-ae@latest/rest/reference/pulls#list-pull-requests\">List pull requests</a> endpoint.</p>",
     "responses": [
       {
         "httpStatusCode": "200",