Update OpenAPI Description (#56871)

Co-authored-by: Felix Guntrip <[email protected]>

Author: docs-bot

src/rest/data/ghec-2022-11-28/schema.json

@@ -1111,13 +1111,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Gets the total GitHub Actions cache usage for an organization.\nThe data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated.</p>\n<p>OAuth tokens and personal access tokens (classic) need the <code>read:org</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Gets the total GitHub Actions cache usage for an organization.\nThe data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated.</p>\n<p>OAuth tokens and personal access tokens (classic) need the <code>read:org</code> scope to use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -4918,13 +4918,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Get the list of partner images available for GitHub-hosted runners for an organization.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Get the list of partner images available for GitHub-hosted runners for an organization.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -6951,13 +6951,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists the organizations that are selected to have GitHub Actions enabled in an enterprise. To use this endpoint, the enterprise permission policy for <code>enabled_organizations</code> must be configured to <code>selected</code>. For more information, see \"<a href=\"#set-github-actions-permissions-for-an-enterprise\">Set GitHub Actions permissions for an enterprise</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:enterprise</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Lists the organizations that are selected to have GitHub Actions enabled in an enterprise. To use this endpoint, the enterprise permission policy for <code>enabled_organizations</code> must be configured to <code>selected</code>. For more information, see \"<a href=\"#set-github-actions-permissions-for-an-enterprise\">Set GitHub Actions permissions for an enterprise</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:enterprise</code> scope to use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -15092,13 +15092,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all self-hosted runner groups configured in an organization and inherited from an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Lists all self-hosted runner groups configured in an organization and inherited from an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -15659,13 +15659,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Updates the <code>name</code> and <code>visibility</code> of a self-hosted runner group in an organization.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Updates the <code>name</code> and <code>visibility</code> of a self-hosted runner group in an organization.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -21884,13 +21884,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all self-hosted runners configured in an organization.</p>\n<p>Authenticated users must have admin access to the organization to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint. If the repository is private, the <code>repo</code> scope is also required.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Lists all self-hosted runners configured in an organization.</p>\n<p>Authenticated users must have admin access to the organization to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint. If the repository is private, the <code>repo</code> scope is also required.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -29338,13 +29338,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all organization variables.</p>\n<p>Authenticated users must have collaborator access to a repository to create, update, or read variables.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint. If the repository is private, the <code>repo</code> scope is also required.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Lists all organization variables.</p>\n<p>Authenticated users must have collaborator access to a repository to create, update, or read variables.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint. If the repository is private, the <code>repo</code> scope is also required.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -44388,13 +44388,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Get all deployment environments for a workflow run that are waiting for protection rules to pass.</p>\n<p>Anyone with read access to the repository can use this endpoint.</p>\n<p>If the repository is private, OAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Get all deployment environments for a workflow run that are waiting for protection rules to pass.</p>\n<p>Anyone with read access to the repository can use this endpoint.</p>\n<p>If the repository is private, OAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -133910,13 +133910,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see <a href=\"https://docs.github.com/enterprise-cloud@latest//github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see <a href=\"https://docs.github.com/enterprise-cloud@latest//github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -152836,13 +152836,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Updates a check run for a specific commit in a repository.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nThe endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty <code>pull_requests</code> array.</p>\n</div>\n<p>OAuth apps and personal access tokens (classic) cannot use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Updates a check run for a specific commit in a repository.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nThe endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty <code>pull_requests</code> array.</p>\n</div>\n<p>OAuth apps and personal access tokens (classic) cannot use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -267162,13 +267162,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all secrets available in an organization without revealing their\nencrypted values.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Lists all secrets available in an organization without revealing their\nencrypted values.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -445175,13 +445175,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Deletes a hosted compute network configuration from an organization.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>write:network_configurations</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "204",
             "description": "<p>No Content</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Deletes a hosted compute network configuration from an organization.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>write:network_configurations</code> scope to use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -478495,13 +478495,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists builts of a GitHub Enterprise Cloud Pages site.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Lists builts of a GitHub Enterprise Cloud Pages site.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -513613,13 +513613,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Gets the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#list-reviews-for-a-pull-request\">List reviews for a pull request</a> operation.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Gets the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#list-reviews-for-a-pull-request\">List reviews for a pull request</a> operation.</p>"
       },
       {
         "serverUrl": "https://api.github.com",
@@ -575738,13 +575738,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists public repositories for the specified user.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Lists public repositories for the specified user.</p>"
       }
     ],
     "autolinks": [
@@ -666729,13 +666729,13 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists external groups available in an organization. You can query the groups using the <code>display_name</code> parameter, only groups with a <code>group_name</code> containing the text provided in the <code>display_name</code> parameter will be returned.  You can also limit your page results using the <code>per_page</code> parameter. GitHub Enterprise Cloud generates a url-encoded <code>page</code> token using a cursor value for where the next page begins. For more information on cursor pagination, see \"<a href=\"https://dev.to/jackmarchant/offset-and-cursor-pagination-explained-b89\">Offset and Cursor Pagination explained</a>.\"</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
             "description": "<p>OK</p>"
           }
-        ]
+        ],
+        "descriptionHTML": "<p>Lists external groups available in an organization. You can query the groups using the <code>display_name</code> parameter, only groups with a <code>group_name</code> containing the text provided in the <code>display_name</code> parameter will be returned.  You can also limit your page results using the <code>per_page</code> parameter. GitHub Enterprise Cloud generates a url-encoded <code>page</code> token using a cursor value for where the next page begins. For more information on cursor pagination, see \"<a href=\"https://dev.to/jackmarchant/offset-and-cursor-pagination-explained-b89\">Offset and Cursor Pagination explained</a>.\"</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>"
       },
       {
         "serverUrl": "https://api.github.com",