Add moved note to process instance migration, backport changes to 8.7 release notes (#5014)

Author: conceptualshark

docs/reference/release-notes/870.md

@@ -129,6 +129,10 @@ To learn more about this feature, see [Git sync](/components/modeler/web-modeler
 
 ### Process Instance Migration <span class="badge badge--long" title="This feature affects SaaS">SaaS</span><span class="badge badge--long" title="This feature affects Self-Managed">Self-Managed</span><span class="badge badge--medium" title="This feature affects Zeebe">Zeebe</span>
 
+:::note
+This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. Process instance migration is now available in [8.8.0-alpha1](./880.md#process-instance-migration-saasself-managedzeebe). For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
+:::
+
 Enhanced process instance migration now supports additional BPMN elements, enabling smoother transitions for your workflows and empowering operations teams to seamlessly migrate running process instances to updated process definitions without workarounds or manual intervention.
 
 You can migrate running process instances containing the following elements:
@@ -262,7 +266,7 @@ To learn more about this feature, see [HTTP Webhook Connector](/components/conne
 #### Spring SDK and Camunda REST API Migration
 
 :::note
-This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. The Camunda REST API migration is now available in 8.8.0-alpha1. For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
+This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. The Camunda REST API migration is now available in [8.8.0-alpha1](./880.md#spring-sdk-and-camunda-rest-api-migration). For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
 :::
 
 The Connectors experience is enhanced with the migration from the Spring Zeebe to the Camunda REST API, and the removal of dependency on the Operate client.

versioned_docs/version-8.7/reference/release-notes/870.md

@@ -49,6 +49,10 @@ A new [ad-hoc subprocess](/components/modeler/bpmn/ad-hoc/ad-hoc.md) BPMN elemen
 
 ### Amazon OpenSearch Optimize support <span class="badge badge--long" title="This feature affects Self-Managed">Self-Managed</span><span class="badge badge--medium" title="This feature affects Optimize">Optimize</span>
 
+:::note
+This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. Amazon OpenSearch Optimize support is now available in [8.8.0-alpha1](/docs/reference/release-notes/880.md#amazon-opensearch-optimize-support-self-managedoptimize). For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
+:::
+
 Camunda 8 Self-Managed now fully supports the use of Amazon OpenSearch with Optimize.
 
 <!-- https://github.com/camunda/product-hub/issues/2374 -->
@@ -125,6 +129,10 @@ To learn more about this feature, see [Git sync](/components/modeler/web-modeler
 
 ### Process Instance Migration <span class="badge badge--long" title="This feature affects SaaS">SaaS</span><span class="badge badge--long" title="This feature affects Self-Managed">Self-Managed</span><span class="badge badge--medium" title="This feature affects Zeebe">Zeebe</span>
 
+:::note
+This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. Process instance migration is now available in [8.8.0-alpha1](/docs/reference/release-notes/880.md#process-instance-migration-saasself-managedzeebe). For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
+:::
+
 Enhanced process instance migration now supports additional BPMN elements, enabling smoother transitions for your workflows and empowering operations teams to seamlessly migrate running process instances to updated process definitions without workarounds or manual intervention.
 
 You can migrate running process instances containing the following elements:
@@ -160,6 +168,10 @@ The predefined development stage cluster for the process application is also use
 
 ### User task listeners <span class="badge badge--long" title="This feature affects SaaS">SaaS</span><span class="badge badge--long" title="This feature affects Self-Managed">Self-Managed</span><span class="badge badge--medium" title="This feature affects Modeler">Modeler</span><span class="badge badge--medium" title="This feature affects Operate">Operate</span>
 
+:::note
+This feature was originally released with 8.7.0-alpha2, and is no longer available in 8.7.0. User task listeners are now available in [8.8.0-alpha1](/docs/reference/release-notes/880.md#user-task-listeners-saasself-managedmodeleroperate). For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
+:::
+
 Task lifecycle management is enhanced with user task listeners, allowing users to react to specific user task lifecycle events.
 
 - Process designers can now model task listeners for different events, such as `assigning` and `completing`.
@@ -168,8 +180,6 @@ Task lifecycle management is enhanced with user task listeners, allowing users t
 
 This enhancement streamlines operations and ensures smoother incident handling, improving time to unblock process execution.
 
-To learn more about this feature, see [user task listeners](/components/concepts/user-task-listeners.md).
-
 <!-- https://github.com/camunda/product-hub/issues/2126 -->
 
 ### Zeebe user tasks modeling migration support <span class="badge badge--long" title="This feature affects SaaS">SaaS</span><span class="badge badge--long" title="This feature affects Self-Managed">Self-Managed</span><span class="badge badge--medium" title="This feature affects Modeler">Modeler</span>
@@ -198,9 +208,11 @@ This [alpha release](/reference/release-policy.md) contains a known issue where
 
 ### Camunda 8 REST API Query API <span class="badge badge--medium" title="This feature affects APIs">API</span>
 
-You can now use a single Query API in the Camunda 8 REST API to find process and decision data instead of using multiple component APIs.
+:::note
+This feature was originally released with 8.7.0-alpha2, and is no longer available in 8.7.0. The Camunda 8 REST API Query API is now available in [8.8.0-alpha1](/docs/reference/release-notes/880.md#camunda-8-rest-api-query-api-api). For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
+:::
 
-For example, send a request to the [Query decision definitions](/apis-tools/camunda-api-rest/specifications/query-decision-definitions-alpha.api.mdx) endpoint to search for decision definitions.
+You can now use a single Query API in the Camunda 8 REST API to find process and decision data instead of using multiple component APIs.
 
 New Query API endpoints are added as follows:
 
@@ -214,8 +226,6 @@ New Query API endpoints are added as follows:
 - User tasks
 - Variables
 
-To learn more about these endpoints, see the [Camunda 8 REST API](/apis-tools/camunda-api-rest/camunda-api-rest-overview.md#query-api) documentation.
-
 ### Connectors <span class="badge badge--long" title="This feature affects SaaS">SaaS</span><span class="badge badge--long" title="This feature affects Self-Managed">Self-Managed</span><span class="badge badge--medium" title="This feature affects Connectors">Connectors</span>
 
 New Connectors and enhancements are included in this release.
@@ -255,6 +265,10 @@ To learn more about this feature, see [HTTP Webhook Connector](/components/conne
 
 #### Spring SDK and Camunda REST API Migration
 
+:::note
+This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. The Camunda REST API migration is now available in [8.8.0-alpha1](/docs/reference/release-notes/880.md#spring-sdk-and-camunda-rest-api-migration). For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
+:::
+
 The Connectors experience is enhanced with the migration from the Spring Zeebe to the Camunda REST API, and the removal of dependency on the Operate client.
 
 #### Testing Support migration
@@ -300,6 +314,10 @@ To learn more about this feature, see [view organization activity](/components/c
 
 ### Process instance migration <span class="badge badge--long" title="This feature affects SaaS">SaaS</span><span class="badge badge--long" title="This feature affects Self-Managed">Self-Managed</span><span class="badge badge--medium" title="This feature affects Zeebe">Zeebe</span>
 
+:::note
+This feature was originally released with 8.7.0-alpha2, and is no longer available in 8.7.0. Process instance migration is now available in [8.8.0-alpha1](/docs/reference/release-notes/880.md#process-instance-migration-saasself-managedzeebe). For more information, see the Camunda 8.7 and 8.8 [release update blog](https://camunda.com/blog/2025/01/camunda-87-88-release-update/).
+:::
+
 Enhanced process instance migration allows you to solve problems with process definitions and use the latest process improvements.
 
 You can now migrate the following:
@@ -308,8 +326,6 @@ You can now migrate the following:
 - Escalation boundary events
 - Escalation event subprocesses
 
-To learn more about migration, see [process instance migration](/components/concepts/process-instance-migration.md).
-
 <!-- https://github.com/camunda/product-hub/issues/2556 -->
 
 ### Singapore region available for SaaS <span class="badge badge--long" title="This feature affects SaaS">SaaS</span>