Describe review workflows webhook payload change (#1766)

* feature: 4.11.3-4.11.4 migration guide

* chore: cleanup

* fix: payload info on webhooks page

* Update docusaurus/docs/dev-docs/migration/v4/migration-guide-4.11.3-to-4.11.4.md

* Update docusaurus/docs/dev-docs/migration/v4/migration-guide-4.11.3-to-4.11.4.md

* Update docusaurus/docs/dev-docs/migration/v4/migration-guide-4.11.3-to-4.11.4.md

* fix: remove migration guide and callout payload change in webhooks doc

* Update docusaurus/docs/dev-docs/backend-customization/webhooks.md

* Update docusaurus/docs/dev-docs/backend-customization/webhooks.md

* Update docusaurus/docs/dev-docs/backend-customization/webhooks.md

---------

Co-authored-by: Pierre Wizla <[email protected]>

Author: jhoward1994

docusaurus/docs/dev-docs/backend-customization/webhooks.md

@@ -443,18 +443,81 @@ This event is only available with the <EnterpriseBadge/> edition of Strapi.<br /
 ```json
 {
   "event": "review-workflows.updateEntryStage",
-  "createdAt": "2020-01-10T11:02:46.232Z",
-  "model": "address",
-  "uid": "api::address.address",
+  "createdAt": "2023-06-26T15:46:35.664Z",
+  "model": "model",
+  "uid": "uid",
+  "entity": {
+    "id": 2
+  },
+  "workflow": {
+    "id": 1,
+    "stages": {
+      "from": {
+        "id": 1,
+        "name": "Stage 1"
+      },
+      "to": {
+        "id": 2,
+        "name": "Stage 2"
+      }
+    }
+  }
+}
+```
+
+:::caution Payload format for Strapi v4.11.4+
+The payload format for the `review-workflows.updateEntryStage` webhook changed between Strapi v4.11.3 and Strapi v4.11.4. Please notice the payload format differences in the following examples and update your integration code accordingly:
+
+<details>
+<summary>Payload formats for Strapi v4.11.3 vs. Strapi v4.11.4</summary>
+
+In Strapi v4.11.3 the webhook payload has the following structure:
+
+```json
+{
+  "event": "review-workflows.updateEntryStage",
+  "createdAt": "2023-06-30T11:40:00.658Z",
+  "model": "model",
+  "uid": "uid",
   "entry": {
-    "entityId": 1,
+    "entityId": 2,
     "workflow": {
       "id": 1,
       "stages": {
-        "from": 2,
-        "to": 1
+        "from": 1,
+        "to": 2
+      }
+    }
+  }
+}
+```
+
+In Strapi v4.11.4 the webhook payload has the following structure:
+
+```json
+{
+  "event": "review-workflows.updateEntryStage",
+  "createdAt": "2023-06-26T15:46:35.664Z",
+  "model": "model",
+  "uid": "uid",
+  "entity": {
+    "id": 2
+  },
+  "workflow": {
+    "id": 1,
+    "stages": {
+      "from": {
+        "id": 1,
+        "name": "Stage 1"
+      },
+      "to": {
+        "id": 2,
+        "name": "Stage 2"
       }
     }
   }
 }
 ```
+
+</details>
+:::

docusaurus/docs/dev-docs/migration-guides.md

@@ -8,7 +8,9 @@ sidebarDepth: 0
 
 # Migration guides
 
-Migrations are necessary when upgrades to Strapi include breaking changes. The migration guides are sequential, meaning if there is more than 1 migration guide between your current version and the latest release, follow each guide in order. If there is no specific migration guide between your current version and the latest release follow the [Upgrade Strapi guide](/dev-docs/update-version.md).
+Migrations are necessary when upgrades to Strapi include breaking changes. The migration guides are sequential, meaning if there is more than 1 migration guide between your current version and the latest release, follow each guide in order.
+
+If there is no specific migration guide between your current version and the latest release, you only need to follow the [guide to upgrade Strapi](/dev-docs/update-version.md).
 
 :::caution
 [Plugins extension](/dev-docs/plugins/users-permissions) that create custom code or modify existing code will need to be updated and compared to the changes in the repository. Not updating the plugin extensions could break the application.