GraphQL schema update (#63534)

Co-authored-by: github-merge-queue <118344674+github-merge-queue@users.noreply.github.com>

Author: docs-bot

src/graphql/data/fpt/schema-pulls.json

@@ -615,7 +615,7 @@
       "name": "mergePullRequest",
       "id": "mergepullrequest",
       "href": "/graphql/reference/pulls#mutation-mergepullrequest",
-      "description": "<p>Merge a pull request.</p>",
+      "description": "<p>Merge a pull request.</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></p>\n<p>\nWe recommend using the <a href=\"/en/rest/pulls/pulls#merge-a-pull-request-asynchronously\">asynchronous merge REST\nAPI</a> instead.\nThis mutation does not support stacked pull requests.</p>\n</div>",
       "isDeprecated": false,
       "inputFields": [
         {

src/graphql/data/fpt/schema.docs.graphql

@@ -28648,6 +28648,11 @@ type Mutation @docsCategory(name: "meta") {
 
   """
   Merge a pull request.
+
+  > [!NOTE]
+  > We recommend using the [asynchronous merge REST
+  API](${externalDocsUrl}/rest/pulls/pulls#merge-a-pull-request-asynchronously) instead.
+  > This mutation does not support stacked pull requests.
   """
   mergePullRequest(
     """

src/graphql/data/ghec/schema-pulls.json

@@ -615,7 +615,7 @@
       "name": "mergePullRequest",
       "id": "mergepullrequest",
       "href": "/graphql/reference/pulls#mutation-mergepullrequest",
-      "description": "<p>Merge a pull request.</p>",
+      "description": "<p>Merge a pull request.</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></p>\n<p>\nWe recommend using the <a href=\"/en/enterprise-cloud@latest/rest/pulls/pulls#merge-a-pull-request-asynchronously\">asynchronous merge REST\nAPI</a> instead.\nThis mutation does not support stacked pull requests.</p>\n</div>",
       "isDeprecated": false,
       "inputFields": [
         {

src/graphql/data/ghec/schema.docs.graphql

@@ -28648,6 +28648,11 @@ type Mutation @docsCategory(name: "meta") {
 
   """
   Merge a pull request.
+
+  > [!NOTE]
+  > We recommend using the [asynchronous merge REST
+  API](${externalDocsUrl}/rest/pulls/pulls#merge-a-pull-request-asynchronously) instead.
+  > This mutation does not support stacked pull requests.
   """
   mergePullRequest(
     """