From 910a6dff824e31a02ee4090a707bc7457a462117 Mon Sep 17 00:00:00 2001
From: Amara Graham <akeller@users.noreply.github.com>
Date: Wed, 26 Feb 2025 11:45:09 -0600
Subject: [PATCH] Fix DocCardLists to their hardcoded version (#5088)

* add DocCardList fixes, hardcode to 8.4

* revert /next/

* add DocCardList fixes, hardcode to 8.5

* add DocCardList fixes, hardcode to 8.6

* add DocCardList fixes, hardcode to 8.7

* revert some back

* optimize link
---
 .../best-practices/best-practices-overview.md | 60 +++++++++----------
 .../migrate-to-zeebe-user-tasks.md            |  4 +-
 .../apis-tools/working-with-apis-tools.md     |  2 +-
 .../best-practices/best-practices-overview.md | 60 +++++++++----------
 .../guides/introduction-to-camunda-8.md       |  4 +-
 .../migrate-to-zeebe-user-tasks.md            |  4 +-
 .../best-practices/best-practices-overview.md | 60 +++++++++----------
 .../guides/introduction-to-camunda-8.md       |  4 +-
 .../migrate-to-camunda-user-tasks.md          |  4 +-
 .../apis-tools/working-with-apis-tools.md     | 20 +++----
 .../best-practices/best-practices-overview.md | 60 +++++++++----------
 11 files changed, 140 insertions(+), 142 deletions(-)

diff --git a/versioned_docs/version-8.4/components/best-practices/best-practices-overview.md b/versioned_docs/version-8.4/components/best-practices/best-practices-overview.md
index 8974326b568..322035e803e 100644
--- a/versioned_docs/version-8.4/components/best-practices/best-practices-overview.md
+++ b/versioned_docs/version-8.4/components/best-practices/best-practices-overview.md
@@ -15,108 +15,108 @@ In general, best practices apply to Camunda 8, but there are also some specific
 
 ## Project management Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/management/following-the-customer-success-path/", label: "The Customer Success Path", docId:"components/best-practices/management/following-the-customer-success-path"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/management/following-the-customer-success-path/", label: "The Customer Success Path", docId:"components/best-practices/management/following-the-customer-success-path"},
 {
-type:"link", href:"/docs/next/components/best-practices/management/doing-a-proper-poc/", label: "Proper POC Execution", docId:"components/best-practices/management/doing-a-proper-poc"
+type:"link", href:"/docs/8.4/components/best-practices/management/doing-a-proper-poc/", label: "Proper POC Execution", docId:"components/best-practices/management/doing-a-proper-poc"
 }
 ]}/>
 
 ## Architecture Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/deciding-about-your-stack/", label: "Choosing Your Tech Stack", docId:"components/best-practices/architecture/deciding-about-your-stack"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/architecture/deciding-about-your-stack/", label: "Choosing Your Tech Stack", docId:"components/best-practices/architecture/deciding-about-your-stack"},
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/sizing-your-environment/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment",
+type:"link", href:"/docs/8.4/components/best-practices/architecture/sizing-your-environment/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/understanding-human-tasks-management/", label: "Human Task Management", docId:"components/best-practices/architecture/understanding-human-tasks-management"
+type:"link", href:"/docs/8.4/components/best-practices/architecture/understanding-human-tasks-management/", label: "Human Task Management", docId:"components/best-practices/architecture/understanding-human-tasks-management"
 }
 ]}/>
 
 ## Development Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/development/connecting-the-workflow-engine-with-your-world/", label: "Workflow Engine Integration", docId:"components/best-practices/development/connecting-the-workflow-engine-with-your-world"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/development/connecting-the-workflow-engine-with-your-world/", label: "Workflow Engine Integration", docId:"components/best-practices/development/connecting-the-workflow-engine-with-your-world"},
 {
-type:"link", href:"/docs/next/components/best-practices/development/service-integration-patterns/", label: "Service Integration Patterns", docId:"components/best-practices/development/service-integration-patterns",
+type:"link", href:"/docs/8.4/components/best-practices/development/service-integration-patterns/", label: "Service Integration Patterns", docId:"components/best-practices/development/service-integration-patterns",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/writing-good-workers/", label: "Writing Effective Workers", docId:"components/best-practices/development/writing-good-workers",
+type:"link", href:"/docs/8.4/components/best-practices/development/writing-good-workers/", label: "Writing Effective Workers", docId:"components/best-practices/development/writing-good-workers",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/dealing-with-problems-and-exceptions/", label: "Problems and Exceptions", docId:"components/best-practices/development/dealing-with-problems-and-exceptions",
+type:"link", href:"/docs/8.4/components/best-practices/development/dealing-with-problems-and-exceptions/", label: "Problems and Exceptions", docId:"components/best-practices/development/dealing-with-problems-and-exceptions",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/handling-data-in-processes/", label: "Data Handling in Processes", docId:"components/best-practices/development/handling-data-in-processes",
+type:"link", href:"/docs/8.4/components/best-practices/development/handling-data-in-processes/", label: "Data Handling in Processes", docId:"components/best-practices/development/handling-data-in-processes",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/routing-events-to-processes/", label: "Routing Events to Processes", docId:"components/best-practices/development/routing-events-to-processes",
+type:"link", href:"/docs/8.4/components/best-practices/development/routing-events-to-processes/", label: "Routing Events to Processes", docId:"components/best-practices/development/routing-events-to-processes",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/testing-process-definitions/", label: "Testing Process Definitions", docId:"components/best-practices/development/testing-process-definitions"
+type:"link", href:"/docs/8.4/components/best-practices/development/testing-process-definitions/", label: "Testing Process Definitions", docId:"components/best-practices/development/testing-process-definitions"
 }
 ]}/>
 
 ## Modeling Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/modeling/creating-readable-process-models/", label: "Readable Process Models", docId:"components/best-practices/modeling/creating-readable-process-models"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/modeling/creating-readable-process-models/", label: "Readable Process Models", docId:"components/best-practices/modeling/creating-readable-process-models"},
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/naming-bpmn-elements/", label: "Naming BPMN Elements", docId:"components/best-practices/modeling/naming-bpmn-elements",
+type:"link", href:"/docs/8.4/components/best-practices/modeling/naming-bpmn-elements/", label: "Naming BPMN Elements", docId:"components/best-practices/modeling/naming-bpmn-elements",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/naming-technically-relevant-ids/", label: "Technically Relevant IDs", docId:"components/best-practices/modeling/naming-technically-relevant-ids",
+type:"link", href:"/docs/8.4/components/best-practices/modeling/naming-technically-relevant-ids/", label: "Technically Relevant IDs", docId:"components/best-practices/modeling/naming-technically-relevant-ids",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/modeling-beyond-the-happy-path/", label: "Model Beyond the Happy Path", docId:"components/best-practices/modeling/modeling-beyond-the-happy-path",
+type:"link", href:"/docs/8.4/components/best-practices/modeling/modeling-beyond-the-happy-path/", label: "Model Beyond the Happy Path", docId:"components/best-practices/modeling/modeling-beyond-the-happy-path",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/modeling-with-situation-patterns/", label: "Situation Patterns", docId:"components/best-practices/modeling/modeling-with-situation-patterns",
+type:"link", href:"/docs/8.4/components/best-practices/modeling/modeling-with-situation-patterns/", label: "Situation Patterns", docId:"components/best-practices/modeling/modeling-with-situation-patterns",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/building-flexibility-into-bpmn-models/", label: "Building Flexibility in BPMN", docId:"components/best-practices/modeling/building-flexibility-into-bpmn-models",
+type:"link", href:"/docs/8.4/components/best-practices/modeling/building-flexibility-into-bpmn-models/", label: "Building Flexibility in BPMN", docId:"components/best-practices/modeling/building-flexibility-into-bpmn-models",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/choosing-the-dmn-hit-policy/", label: "Choosing DMN Hit Policy", docId:"components/best-practices/modeling/choosing-the-dmn-hit-policy"
+type:"link", href:"/docs/8.4/components/best-practices/modeling/choosing-the-dmn-hit-policy/", label: "Choosing DMN Hit Policy", docId:"components/best-practices/modeling/choosing-the-dmn-hit-policy"
 }
 ]}/>
 
 ## Operations Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/operations/versioning-process-definitions/", label: "Versioning Process Definitions", docId:"components/best-practices/operations/versioning-process-definitions"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/operations/versioning-process-definitions/", label: "Versioning Process Definitions", docId:"components/best-practices/operations/versioning-process-definitions"},
 {
-type:"link", href:"/docs/next/components/best-practices/operations/reporting-about-processes/", label: "Process Reporting", docId:"components/best-practices/operations/reporting-about-processes"
+type:"link", href:"/docs/8.4/components/best-practices/operations/reporting-about-processes/", label: "Process Reporting", docId:"components/best-practices/operations/reporting-about-processes"
 }
 ]}/>
 
 ## Camunda 7-specific Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/deciding-about-your-stack-c7/", label: "Tech Stack Decisions", docId:"components/best-practices/architecture/deciding-about-your-stack-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/architecture/deciding-about-your-stack-c7/", label: "Tech Stack Decisions", docId:"components/best-practices/architecture/deciding-about-your-stack-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/sizing-your-environment-c7/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment-c7"
+type:"link", href:"/docs/8.4/components/best-practices/architecture/sizing-your-environment-c7/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment-c7"
 }
 ]}/>
 
 ### Development
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/development/invoking-services-from-the-process-c7/", label: "Service Invocation", docId:"components/best-practices/development/invoking-services-from-the-process-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/development/invoking-services-from-the-process-c7/", label: "Service Invocation", docId:"components/best-practices/development/invoking-services-from-the-process-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/development/understanding-transaction-handling-c7/", label: "Transaction Handling", docId:"components/best-practices/development/understanding-transaction-handling-c7"
+type:"link", href:"/docs/8.4/components/best-practices/development/understanding-transaction-handling-c7/", label: "Transaction Handling", docId:"components/best-practices/development/understanding-transaction-handling-c7"
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/testing-process-definitions-c7/", label: "Testing process definitions in Camunda 7", docId:"components/best-practices/development/testing-process-definitions-c7"
+type:"link", href:"/docs/8.4/components/best-practices/development/testing-process-definitions-c7/", label: "Testing process definitions in Camunda 7", docId:"components/best-practices/development/testing-process-definitions-c7"
 }
 ]}/>
 
 ### Operations
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/operations/operating-camunda-c7/", label: "Operating Camunda 7", docId:"components/best-practices/operations/operating-camunda-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/operations/operating-camunda-c7/", label: "Operating Camunda 7", docId:"components/best-practices/operations/operating-camunda-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/operations/performance-tuning-camunda-c7/", label: "Performance Tuning", docId:"components/best-practices/operations/performance-tuning-camunda-c7",
+type:"link", href:"/docs/8.4/components/best-practices/operations/performance-tuning-camunda-c7/", label: "Performance Tuning", docId:"components/best-practices/operations/performance-tuning-camunda-c7",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/operations/securing-camunda-c7/", label: "Securing Camunda 7", docId:"components/best-practices/operations/securing-camunda-c7"
+type:"link", href:"/docs/8.4/components/best-practices/operations/securing-camunda-c7/", label: "Securing Camunda 7", docId:"components/best-practices/operations/securing-camunda-c7"
 }
 ]}/>
 
 ### Other
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/extending-human-task-management-c7/", label: "Extending Human Task Management", docId:"components/best-practices/architecture/extending-human-task-management-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.4/components/best-practices/architecture/extending-human-task-management-c7/", label: "Extending Human Task Management", docId:"components/best-practices/architecture/extending-human-task-management-c7"},
 ]}/>
diff --git a/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md b/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md
index 74c98363912..391348ddf71 100644
--- a/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md
+++ b/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md
@@ -360,14 +360,12 @@ Use the Zeebe Java client when you are building your task application in Java. T
 
 ### API differences
 
-<!-- TODO two cards to link to boh API docs, once available -->
-
 Refer to the dedicated sections and API explorers to learn details about the APIs.
 
 <DocCardList items={[
 {
 type:"link",
-href:"/docs/next/apis-tools/tasklist-api-rest/tasklist-api-rest-overview/",
+href:"/docs/8.5/apis-tools/tasklist-api-rest/tasklist-api-rest-overview/",
 label: "Tasklist API (REST)",
 docId:"apis-tools/tasklist-api-rest/tasklist-api-rest-overview"
 },
diff --git a/versioned_docs/version-8.5/apis-tools/working-with-apis-tools.md b/versioned_docs/version-8.5/apis-tools/working-with-apis-tools.md
index 57e5bbf0d50..a82b17b3ea5 100644
--- a/versioned_docs/version-8.5/apis-tools/working-with-apis-tools.md
+++ b/versioned_docs/version-8.5/apis-tools/working-with-apis-tools.md
@@ -85,7 +85,7 @@ Additionally, visit our documentation on [Operate](../self-managed/operate-deplo
 
 <DocCardList items={[{type:"link", href:"/docs/8.5/apis-tools/spring-zeebe-sdk/getting-started/", label: "Spring Zeebe", docId:"apis-tools/spring-zeebe-sdk/getting-started"},
 {
-type:"link", href:"/docs/next/apis-tools/node-js-sdk/", label: "Node.js", docId:"apis-tools/node-js-sdk"
+type:"link", href:"/docs/8.5/apis-tools/node-js-sdk/", label: "Node.js", docId:"apis-tools/node-js-sdk"
 },
 ]}/>
 
diff --git a/versioned_docs/version-8.5/components/best-practices/best-practices-overview.md b/versioned_docs/version-8.5/components/best-practices/best-practices-overview.md
index 8974326b568..eca2f04e797 100644
--- a/versioned_docs/version-8.5/components/best-practices/best-practices-overview.md
+++ b/versioned_docs/version-8.5/components/best-practices/best-practices-overview.md
@@ -15,108 +15,108 @@ In general, best practices apply to Camunda 8, but there are also some specific
 
 ## Project management Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/management/following-the-customer-success-path/", label: "The Customer Success Path", docId:"components/best-practices/management/following-the-customer-success-path"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/management/following-the-customer-success-path/", label: "The Customer Success Path", docId:"components/best-practices/management/following-the-customer-success-path"},
 {
-type:"link", href:"/docs/next/components/best-practices/management/doing-a-proper-poc/", label: "Proper POC Execution", docId:"components/best-practices/management/doing-a-proper-poc"
+type:"link", href:"/docs/8.5/components/best-practices/management/doing-a-proper-poc/", label: "Proper POC Execution", docId:"components/best-practices/management/doing-a-proper-poc"
 }
 ]}/>
 
 ## Architecture Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/deciding-about-your-stack/", label: "Choosing Your Tech Stack", docId:"components/best-practices/architecture/deciding-about-your-stack"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/architecture/deciding-about-your-stack/", label: "Choosing Your Tech Stack", docId:"components/best-practices/architecture/deciding-about-your-stack"},
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/sizing-your-environment/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment",
+type:"link", href:"/docs/8.5/components/best-practices/architecture/sizing-your-environment/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/understanding-human-tasks-management/", label: "Human Task Management", docId:"components/best-practices/architecture/understanding-human-tasks-management"
+type:"link", href:"/docs/8.5/components/best-practices/architecture/understanding-human-tasks-management/", label: "Human Task Management", docId:"components/best-practices/architecture/understanding-human-tasks-management"
 }
 ]}/>
 
 ## Development Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/development/connecting-the-workflow-engine-with-your-world/", label: "Workflow Engine Integration", docId:"components/best-practices/development/connecting-the-workflow-engine-with-your-world"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/development/connecting-the-workflow-engine-with-your-world/", label: "Workflow Engine Integration", docId:"components/best-practices/development/connecting-the-workflow-engine-with-your-world"},
 {
-type:"link", href:"/docs/next/components/best-practices/development/service-integration-patterns/", label: "Service Integration Patterns", docId:"components/best-practices/development/service-integration-patterns",
+type:"link", href:"/docs/8.5/components/best-practices/development/service-integration-patterns/", label: "Service Integration Patterns", docId:"components/best-practices/development/service-integration-patterns",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/writing-good-workers/", label: "Writing Effective Workers", docId:"components/best-practices/development/writing-good-workers",
+type:"link", href:"/docs/8.5/components/best-practices/development/writing-good-workers/", label: "Writing Effective Workers", docId:"components/best-practices/development/writing-good-workers",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/dealing-with-problems-and-exceptions/", label: "Problems and Exceptions", docId:"components/best-practices/development/dealing-with-problems-and-exceptions",
+type:"link", href:"/docs/8.5/components/best-practices/development/dealing-with-problems-and-exceptions/", label: "Problems and Exceptions", docId:"components/best-practices/development/dealing-with-problems-and-exceptions",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/handling-data-in-processes/", label: "Data Handling in Processes", docId:"components/best-practices/development/handling-data-in-processes",
+type:"link", href:"/docs/8.5/components/best-practices/development/handling-data-in-processes/", label: "Data Handling in Processes", docId:"components/best-practices/development/handling-data-in-processes",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/routing-events-to-processes/", label: "Routing Events to Processes", docId:"components/best-practices/development/routing-events-to-processes",
+type:"link", href:"/docs/8.5/components/best-practices/development/routing-events-to-processes/", label: "Routing Events to Processes", docId:"components/best-practices/development/routing-events-to-processes",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/testing-process-definitions/", label: "Testing Process Definitions", docId:"components/best-practices/development/testing-process-definitions"
+type:"link", href:"/docs/8.5/components/best-practices/development/testing-process-definitions/", label: "Testing Process Definitions", docId:"components/best-practices/development/testing-process-definitions"
 }
 ]}/>
 
 ## Modeling Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/modeling/creating-readable-process-models/", label: "Readable Process Models", docId:"components/best-practices/modeling/creating-readable-process-models"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/modeling/creating-readable-process-models/", label: "Readable Process Models", docId:"components/best-practices/modeling/creating-readable-process-models"},
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/naming-bpmn-elements/", label: "Naming BPMN Elements", docId:"components/best-practices/modeling/naming-bpmn-elements",
+type:"link", href:"/docs/8.5/components/best-practices/modeling/naming-bpmn-elements/", label: "Naming BPMN Elements", docId:"components/best-practices/modeling/naming-bpmn-elements",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/naming-technically-relevant-ids/", label: "Technically Relevant IDs", docId:"components/best-practices/modeling/naming-technically-relevant-ids",
+type:"link", href:"/docs/8.5/components/best-practices/modeling/naming-technically-relevant-ids/", label: "Technically Relevant IDs", docId:"components/best-practices/modeling/naming-technically-relevant-ids",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/modeling-beyond-the-happy-path/", label: "Model Beyond the Happy Path", docId:"components/best-practices/modeling/modeling-beyond-the-happy-path",
+type:"link", href:"/docs/8.5/components/best-practices/modeling/modeling-beyond-the-happy-path/", label: "Model Beyond the Happy Path", docId:"components/best-practices/modeling/modeling-beyond-the-happy-path",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/modeling-with-situation-patterns/", label: "Situation Patterns", docId:"components/best-practices/modeling/modeling-with-situation-patterns",
+type:"link", href:"/docs/8.5/components/best-practices/modeling/modeling-with-situation-patterns/", label: "Situation Patterns", docId:"components/best-practices/modeling/modeling-with-situation-patterns",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/building-flexibility-into-bpmn-models/", label: "Building Flexibility in BPMN", docId:"components/best-practices/modeling/building-flexibility-into-bpmn-models",
+type:"link", href:"/docs/8.5/components/best-practices/modeling/building-flexibility-into-bpmn-models/", label: "Building Flexibility in BPMN", docId:"components/best-practices/modeling/building-flexibility-into-bpmn-models",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/choosing-the-dmn-hit-policy/", label: "Choosing DMN Hit Policy", docId:"components/best-practices/modeling/choosing-the-dmn-hit-policy"
+type:"link", href:"/docs/8.5/components/best-practices/modeling/choosing-the-dmn-hit-policy/", label: "Choosing DMN Hit Policy", docId:"components/best-practices/modeling/choosing-the-dmn-hit-policy"
 }
 ]}/>
 
 ## Operations Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/operations/versioning-process-definitions/", label: "Versioning Process Definitions", docId:"components/best-practices/operations/versioning-process-definitions"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/operations/versioning-process-definitions/", label: "Versioning Process Definitions", docId:"components/best-practices/operations/versioning-process-definitions"},
 {
-type:"link", href:"/docs/next/components/best-practices/operations/reporting-about-processes/", label: "Process Reporting", docId:"components/best-practices/operations/reporting-about-processes"
+type:"link", href:"/docs/8.5/components/best-practices/operations/reporting-about-processes/", label: "Process Reporting", docId:"components/best-practices/operations/reporting-about-processes"
 }
 ]}/>
 
 ## Camunda 7-specific Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/deciding-about-your-stack-c7/", label: "Tech Stack Decisions", docId:"components/best-practices/architecture/deciding-about-your-stack-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/architecture/deciding-about-your-stack-c7/", label: "Tech Stack Decisions", docId:"components/best-practices/architecture/deciding-about-your-stack-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/sizing-your-environment-c7/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment-c7"
+type:"link", href:"/docs/8.5/components/best-practices/architecture/sizing-your-environment-c7/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment-c7"
 }
 ]}/>
 
 ### Development
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/development/invoking-services-from-the-process-c7/", label: "Service Invocation", docId:"components/best-practices/development/invoking-services-from-the-process-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/development/invoking-services-from-the-process-c7/", label: "Service Invocation", docId:"components/best-practices/development/invoking-services-from-the-process-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/development/understanding-transaction-handling-c7/", label: "Transaction Handling", docId:"components/best-practices/development/understanding-transaction-handling-c7"
+type:"link", href:"/docs/8.5/components/best-practices/development/understanding-transaction-handling-c7/", label: "Transaction Handling", docId:"components/best-practices/development/understanding-transaction-handling-c7"
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/testing-process-definitions-c7/", label: "Testing process definitions in Camunda 7", docId:"components/best-practices/development/testing-process-definitions-c7"
+type:"link", href:"/docs/8.5/components/best-practices/development/testing-process-definitions-c7/", label: "Testing process definitions in Camunda 7", docId:"components/best-practices/development/testing-process-definitions-c7"
 }
 ]}/>
 
 ### Operations
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/operations/operating-camunda-c7/", label: "Operating Camunda 7", docId:"components/best-practices/operations/operating-camunda-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/operations/operating-camunda-c7/", label: "Operating Camunda 7", docId:"components/best-practices/operations/operating-camunda-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/operations/performance-tuning-camunda-c7/", label: "Performance Tuning", docId:"components/best-practices/operations/performance-tuning-camunda-c7",
+type:"link", href:"/docs/8.5/components/best-practices/operations/performance-tuning-camunda-c7/", label: "Performance Tuning", docId:"components/best-practices/operations/performance-tuning-camunda-c7",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/operations/securing-camunda-c7/", label: "Securing Camunda 7", docId:"components/best-practices/operations/securing-camunda-c7"
+type:"link", href:"/docs/8.5/components/best-practices/operations/securing-camunda-c7/", label: "Securing Camunda 7", docId:"components/best-practices/operations/securing-camunda-c7"
 }
 ]}/>
 
 ### Other
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/extending-human-task-management-c7/", label: "Extending Human Task Management", docId:"components/best-practices/architecture/extending-human-task-management-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/best-practices/architecture/extending-human-task-management-c7/", label: "Extending Human Task Management", docId:"components/best-practices/architecture/extending-human-task-management-c7"},
 ]}/>
diff --git a/versioned_docs/version-8.5/guides/introduction-to-camunda-8.md b/versioned_docs/version-8.5/guides/introduction-to-camunda-8.md
index 74ef3f25773..f090086b0b5 100644
--- a/versioned_docs/version-8.5/guides/introduction-to-camunda-8.md
+++ b/versioned_docs/version-8.5/guides/introduction-to-camunda-8.md
@@ -30,9 +30,9 @@ Deployment guides for Camunda 8 components are available in the [Self-Managed se
 
 Below are two excellent starting points if you're new to Camunda: modeling a process, and getting started with Spring:
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/modeler/about-modeler/", label: "Model your first process", docId:"components/modeler/about-modeler"},
+<DocCardList items={[{type:"link", href:"/docs/8.5/components/modeler/about-modeler/", label: "Model your first process", docId:"components/modeler/about-modeler"},
 {
-type:"link", href:"/docs/next/guides/getting-started-java-spring/", label: "Get started with Spring", docId:"guides/getting-started-java-spring",
+type:"link", href:"/docs/8.5/guides/getting-started-java-spring/", label: "Get started with Spring", docId:"guides/getting-started-java-spring",
 }
 ]}/>
 
diff --git a/versioned_docs/version-8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md b/versioned_docs/version-8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md
index b3d1722d537..e0bc4759124 100644
--- a/versioned_docs/version-8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md
+++ b/versioned_docs/version-8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md
@@ -307,13 +307,13 @@ Refer to the dedicated sections and API explorers to learn details about the API
 <DocCardList items={[
 {
 type:"link",
-href:"/docs/next/apis-tools/tasklist-api-rest/tasklist-api-rest-overview/",
+href:"/docs/apis-tools/tasklist-api-rest/tasklist-api-rest-overview/",
 label: "Tasklist API (REST)",
 docId:"apis-tools/tasklist-api-rest/tasklist-api-rest-overview"
 },
 {
 type:"link",
-href:"/docs/next/apis-tools/camunda-api-rest/camunda-api-rest-overview/",
+href:"/docs/apis-tools/camunda-api-rest/camunda-api-rest-overview/",
 label: "Camunda 8 API (REST)",
 docId:"apis-tools/camunda-api-rest/camunda-api-rest-overview"
 }
diff --git a/versioned_docs/version-8.6/components/best-practices/best-practices-overview.md b/versioned_docs/version-8.6/components/best-practices/best-practices-overview.md
index 8974326b568..354498d8a65 100644
--- a/versioned_docs/version-8.6/components/best-practices/best-practices-overview.md
+++ b/versioned_docs/version-8.6/components/best-practices/best-practices-overview.md
@@ -15,108 +15,108 @@ In general, best practices apply to Camunda 8, but there are also some specific
 
 ## Project management Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/management/following-the-customer-success-path/", label: "The Customer Success Path", docId:"components/best-practices/management/following-the-customer-success-path"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/management/following-the-customer-success-path/", label: "The Customer Success Path", docId:"components/best-practices/management/following-the-customer-success-path"},
 {
-type:"link", href:"/docs/next/components/best-practices/management/doing-a-proper-poc/", label: "Proper POC Execution", docId:"components/best-practices/management/doing-a-proper-poc"
+type:"link", href:"/docs/components/best-practices/management/doing-a-proper-poc/", label: "Proper POC Execution", docId:"components/best-practices/management/doing-a-proper-poc"
 }
 ]}/>
 
 ## Architecture Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/deciding-about-your-stack/", label: "Choosing Your Tech Stack", docId:"components/best-practices/architecture/deciding-about-your-stack"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/architecture/deciding-about-your-stack/", label: "Choosing Your Tech Stack", docId:"components/best-practices/architecture/deciding-about-your-stack"},
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/sizing-your-environment/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment",
+type:"link", href:"/docs/components/best-practices/architecture/sizing-your-environment/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/understanding-human-tasks-management/", label: "Human Task Management", docId:"components/best-practices/architecture/understanding-human-tasks-management"
+type:"link", href:"/docs/components/best-practices/architecture/understanding-human-tasks-management/", label: "Human Task Management", docId:"components/best-practices/architecture/understanding-human-tasks-management"
 }
 ]}/>
 
 ## Development Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/development/connecting-the-workflow-engine-with-your-world/", label: "Workflow Engine Integration", docId:"components/best-practices/development/connecting-the-workflow-engine-with-your-world"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/development/connecting-the-workflow-engine-with-your-world/", label: "Workflow Engine Integration", docId:"components/best-practices/development/connecting-the-workflow-engine-with-your-world"},
 {
-type:"link", href:"/docs/next/components/best-practices/development/service-integration-patterns/", label: "Service Integration Patterns", docId:"components/best-practices/development/service-integration-patterns",
+type:"link", href:"/docs/components/best-practices/development/service-integration-patterns/", label: "Service Integration Patterns", docId:"components/best-practices/development/service-integration-patterns",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/writing-good-workers/", label: "Writing Effective Workers", docId:"components/best-practices/development/writing-good-workers",
+type:"link", href:"/docs/components/best-practices/development/writing-good-workers/", label: "Writing Effective Workers", docId:"components/best-practices/development/writing-good-workers",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/dealing-with-problems-and-exceptions/", label: "Problems and Exceptions", docId:"components/best-practices/development/dealing-with-problems-and-exceptions",
+type:"link", href:"/docs/components/best-practices/development/dealing-with-problems-and-exceptions/", label: "Problems and Exceptions", docId:"components/best-practices/development/dealing-with-problems-and-exceptions",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/handling-data-in-processes/", label: "Data Handling in Processes", docId:"components/best-practices/development/handling-data-in-processes",
+type:"link", href:"/docs/components/best-practices/development/handling-data-in-processes/", label: "Data Handling in Processes", docId:"components/best-practices/development/handling-data-in-processes",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/routing-events-to-processes/", label: "Routing Events to Processes", docId:"components/best-practices/development/routing-events-to-processes",
+type:"link", href:"/docs/components/best-practices/development/routing-events-to-processes/", label: "Routing Events to Processes", docId:"components/best-practices/development/routing-events-to-processes",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/testing-process-definitions/", label: "Testing Process Definitions", docId:"components/best-practices/development/testing-process-definitions"
+type:"link", href:"/docs/components/best-practices/development/testing-process-definitions/", label: "Testing Process Definitions", docId:"components/best-practices/development/testing-process-definitions"
 }
 ]}/>
 
 ## Modeling Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/modeling/creating-readable-process-models/", label: "Readable Process Models", docId:"components/best-practices/modeling/creating-readable-process-models"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/modeling/creating-readable-process-models/", label: "Readable Process Models", docId:"components/best-practices/modeling/creating-readable-process-models"},
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/naming-bpmn-elements/", label: "Naming BPMN Elements", docId:"components/best-practices/modeling/naming-bpmn-elements",
+type:"link", href:"/docs/components/best-practices/modeling/naming-bpmn-elements/", label: "Naming BPMN Elements", docId:"components/best-practices/modeling/naming-bpmn-elements",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/naming-technically-relevant-ids/", label: "Technically Relevant IDs", docId:"components/best-practices/modeling/naming-technically-relevant-ids",
+type:"link", href:"/docs/components/best-practices/modeling/naming-technically-relevant-ids/", label: "Technically Relevant IDs", docId:"components/best-practices/modeling/naming-technically-relevant-ids",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/modeling-beyond-the-happy-path/", label: "Model Beyond the Happy Path", docId:"components/best-practices/modeling/modeling-beyond-the-happy-path",
+type:"link", href:"/docs/components/best-practices/modeling/modeling-beyond-the-happy-path/", label: "Model Beyond the Happy Path", docId:"components/best-practices/modeling/modeling-beyond-the-happy-path",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/modeling-with-situation-patterns/", label: "Situation Patterns", docId:"components/best-practices/modeling/modeling-with-situation-patterns",
+type:"link", href:"/docs/components/best-practices/modeling/modeling-with-situation-patterns/", label: "Situation Patterns", docId:"components/best-practices/modeling/modeling-with-situation-patterns",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/building-flexibility-into-bpmn-models/", label: "Building Flexibility in BPMN", docId:"components/best-practices/modeling/building-flexibility-into-bpmn-models",
+type:"link", href:"/docs/components/best-practices/modeling/building-flexibility-into-bpmn-models/", label: "Building Flexibility in BPMN", docId:"components/best-practices/modeling/building-flexibility-into-bpmn-models",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/choosing-the-dmn-hit-policy/", label: "Choosing DMN Hit Policy", docId:"components/best-practices/modeling/choosing-the-dmn-hit-policy"
+type:"link", href:"/docs/components/best-practices/modeling/choosing-the-dmn-hit-policy/", label: "Choosing DMN Hit Policy", docId:"components/best-practices/modeling/choosing-the-dmn-hit-policy"
 }
 ]}/>
 
 ## Operations Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/operations/versioning-process-definitions/", label: "Versioning Process Definitions", docId:"components/best-practices/operations/versioning-process-definitions"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/operations/versioning-process-definitions/", label: "Versioning Process Definitions", docId:"components/best-practices/operations/versioning-process-definitions"},
 {
-type:"link", href:"/docs/next/components/best-practices/operations/reporting-about-processes/", label: "Process Reporting", docId:"components/best-practices/operations/reporting-about-processes"
+type:"link", href:"/docs/components/best-practices/operations/reporting-about-processes/", label: "Process Reporting", docId:"components/best-practices/operations/reporting-about-processes"
 }
 ]}/>
 
 ## Camunda 7-specific Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/deciding-about-your-stack-c7/", label: "Tech Stack Decisions", docId:"components/best-practices/architecture/deciding-about-your-stack-c7"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/architecture/deciding-about-your-stack-c7/", label: "Tech Stack Decisions", docId:"components/best-practices/architecture/deciding-about-your-stack-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/sizing-your-environment-c7/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment-c7"
+type:"link", href:"/docs/components/best-practices/architecture/sizing-your-environment-c7/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment-c7"
 }
 ]}/>
 
 ### Development
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/development/invoking-services-from-the-process-c7/", label: "Service Invocation", docId:"components/best-practices/development/invoking-services-from-the-process-c7"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/development/invoking-services-from-the-process-c7/", label: "Service Invocation", docId:"components/best-practices/development/invoking-services-from-the-process-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/development/understanding-transaction-handling-c7/", label: "Transaction Handling", docId:"components/best-practices/development/understanding-transaction-handling-c7"
+type:"link", href:"/docs/components/best-practices/development/understanding-transaction-handling-c7/", label: "Transaction Handling", docId:"components/best-practices/development/understanding-transaction-handling-c7"
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/testing-process-definitions-c7/", label: "Testing process definitions in Camunda 7", docId:"components/best-practices/development/testing-process-definitions-c7"
+type:"link", href:"/docs/components/best-practices/development/testing-process-definitions-c7/", label: "Testing process definitions in Camunda 7", docId:"components/best-practices/development/testing-process-definitions-c7"
 }
 ]}/>
 
 ### Operations
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/operations/operating-camunda-c7/", label: "Operating Camunda 7", docId:"components/best-practices/operations/operating-camunda-c7"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/operations/operating-camunda-c7/", label: "Operating Camunda 7", docId:"components/best-practices/operations/operating-camunda-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/operations/performance-tuning-camunda-c7/", label: "Performance Tuning", docId:"components/best-practices/operations/performance-tuning-camunda-c7",
+type:"link", href:"/docs/components/best-practices/operations/performance-tuning-camunda-c7/", label: "Performance Tuning", docId:"components/best-practices/operations/performance-tuning-camunda-c7",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/operations/securing-camunda-c7/", label: "Securing Camunda 7", docId:"components/best-practices/operations/securing-camunda-c7"
+type:"link", href:"/docs/components/best-practices/operations/securing-camunda-c7/", label: "Securing Camunda 7", docId:"components/best-practices/operations/securing-camunda-c7"
 }
 ]}/>
 
 ### Other
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/extending-human-task-management-c7/", label: "Extending Human Task Management", docId:"components/best-practices/architecture/extending-human-task-management-c7"},
+<DocCardList items={[{type:"link", href:"/docs/components/best-practices/architecture/extending-human-task-management-c7/", label: "Extending Human Task Management", docId:"components/best-practices/architecture/extending-human-task-management-c7"},
 ]}/>
diff --git a/versioned_docs/version-8.6/guides/introduction-to-camunda-8.md b/versioned_docs/version-8.6/guides/introduction-to-camunda-8.md
index 74ef3f25773..674863e4f4a 100644
--- a/versioned_docs/version-8.6/guides/introduction-to-camunda-8.md
+++ b/versioned_docs/version-8.6/guides/introduction-to-camunda-8.md
@@ -30,9 +30,9 @@ Deployment guides for Camunda 8 components are available in the [Self-Managed se
 
 Below are two excellent starting points if you're new to Camunda: modeling a process, and getting started with Spring:
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/modeler/about-modeler/", label: "Model your first process", docId:"components/modeler/about-modeler"},
+<DocCardList items={[{type:"link", href:"/docs/components/modeler/about-modeler/", label: "Model your first process", docId:"components/modeler/about-modeler"},
 {
-type:"link", href:"/docs/next/guides/getting-started-java-spring/", label: "Get started with Spring", docId:"guides/getting-started-java-spring",
+type:"link", href:"/docs/guides/getting-started-java-spring/", label: "Get started with Spring", docId:"guides/getting-started-java-spring",
 }
 ]}/>
 
diff --git a/versioned_docs/version-8.7/apis-tools/migration-manuals/migrate-to-camunda-user-tasks.md b/versioned_docs/version-8.7/apis-tools/migration-manuals/migrate-to-camunda-user-tasks.md
index 127dde1190a..6ab62af31dd 100644
--- a/versioned_docs/version-8.7/apis-tools/migration-manuals/migrate-to-camunda-user-tasks.md
+++ b/versioned_docs/version-8.7/apis-tools/migration-manuals/migrate-to-camunda-user-tasks.md
@@ -347,13 +347,13 @@ Refer to the dedicated sections and API explorers to learn details about the API
 <DocCardList items={[
 {
 type:"link",
-href:"/docs/next/apis-tools/tasklist-api-rest/tasklist-api-rest-overview/",
+href:"/docs/8.7/apis-tools/tasklist-api-rest/tasklist-api-rest-overview/",
 label: "Tasklist API (REST)",
 docId:"apis-tools/tasklist-api-rest/tasklist-api-rest-overview"
 },
 {
 type:"link",
-href:"/docs/next/apis-tools/camunda-api-rest/camunda-api-rest-overview/",
+href:"/docs/8.7/apis-tools/camunda-api-rest/camunda-api-rest-overview/",
 label: "Camunda 8 API (REST)",
 docId:"apis-tools/camunda-api-rest/camunda-api-rest-overview"
 }
diff --git a/versioned_docs/version-8.7/apis-tools/working-with-apis-tools.md b/versioned_docs/version-8.7/apis-tools/working-with-apis-tools.md
index e413dd21ab8..f71d1b0547d 100644
--- a/versioned_docs/version-8.7/apis-tools/working-with-apis-tools.md
+++ b/versioned_docs/version-8.7/apis-tools/working-with-apis-tools.md
@@ -35,7 +35,7 @@ Camunda 8 provides several official clients based on this API. Official clients
 
 Official clients have been developed and tested by Camunda. They also add convenience functions (e.g. thread handling for job workers) on top of the core API.
 
-<DocCardList items={[{type:"link", href:"/docs/next/apis-tools/java-client/", label: "Java client", docId:"apis-tools/java-client/index"}
+<DocCardList items={[{type:"link", href:"/docs/8.7/apis-tools/java-client/", label: "Java client", docId:"apis-tools/java-client/index"}
 ]}/>
 
 :::note
@@ -54,18 +54,18 @@ Camunda 8 components have APIs to enable polyglot developers to work with in the
 
 ### API Reference
 
-<DocCardList items={[{type:"link", href:"/docs/next/apis-tools/administration-api/administration-api-reference/", label: "Administration API (REST)", docId:"apis-tools/administration-api/administration-api-reference"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/apis-tools/administration-api/administration-api-reference/", label: "Administration API (REST)", docId:"apis-tools/administration-api/administration-api-reference"},
 {
-type:"link", href:"/docs/next/apis-tools/camunda-api-rest/camunda-api-rest-overview/", label: "Camunda 8 API (REST)", docId:"apis-tools/camunda-api-rest/camunda-api-rest-overview"
+type:"link", href:"/docs/8.7/apis-tools/camunda-api-rest/camunda-api-rest-overview/", label: "Camunda 8 API (REST)", docId:"apis-tools/camunda-api-rest/camunda-api-rest-overview"
 },
 {
-type:"link", href:"/optimize/next/apis-tools/optimize-api/optimize-api-authentication/", label: "Optimize API (REST)", description: "Get, delete, and export reports and dashboards, enable and disable sharing, and more."
+type:"link", href:"/optimize/3.15.0/apis-tools/optimize-api/optimize-api-authentication/", label: "Optimize API (REST)", description: "Get, delete, and export reports and dashboards, enable and disable sharing, and more."
 },
 {
-type:"link", href:"/docs/next/apis-tools/web-modeler-api/overview/", label: "Web Modeler API (REST)", docId:"apis-tools/web-modeler-api/overview"
+type:"link", href:"/docs/8.7/apis-tools/web-modeler-api/overview/", label: "Web Modeler API (REST)", docId:"apis-tools/web-modeler-api/overview"
 },
 {
-type:"link", href:"/docs/next/apis-tools/zeebe-api/overview/", label: "Zeebe API (gRPC)", docId:"apis-tools/zeebe-api/grpc"
+type:"link", href:"/docs/8.7/apis-tools/zeebe-api/overview/", label: "Zeebe API (gRPC)", docId:"apis-tools/zeebe-api/grpc"
 }
 ]}/>
 
@@ -75,9 +75,9 @@ Additionally, visit our documentation on [Operate](../self-managed/operate-deplo
 
 ### SDKs
 
-<DocCardList items={[{type:"link", href:"/docs/next/apis-tools/spring-zeebe-sdk/getting-started/", label: "Spring Zeebe", docId:"apis-tools/spring-zeebe-sdk/getting-started"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/apis-tools/spring-zeebe-sdk/getting-started/", label: "Spring Zeebe", docId:"apis-tools/spring-zeebe-sdk/getting-started"},
 {
-type:"link", href:"/docs/next/apis-tools/node-js-sdk/", label: "Node.js", docId:"apis-tools/node-js-sdk"
+type:"link", href:"/docs/8.7/apis-tools/node-js-sdk/", label: "Node.js", docId:"apis-tools/node-js-sdk"
 },
 ]}/>
 
@@ -110,13 +110,13 @@ Camunda 8 provides APIs and JavaScript libraries to allow frontend developers to
 <DocCardList items={[
 {
 type: "link",
-href: "/docs/next/apis-tools/frontend-development/task-applications/introduction-to-task-applications",
+href: "/docs/8.7/apis-tools/frontend-development/task-applications/introduction-to-task-applications",
 label: "Task applications",
 docId:"apis-tools/frontend-development/task-applications/introduction-to-task-applications"
 },
 {
 type: "link",
-href: "/docs/next/apis-tools/frontend-development/forms/introduction-to-forms",
+href: "/docs/8.7/apis-tools/frontend-development/forms/introduction-to-forms",
 label: "Forms",
 docId: "apis-tools/frontend-development/forms/introduction-to-forms"
 }
diff --git a/versioned_docs/version-8.7/components/best-practices/best-practices-overview.md b/versioned_docs/version-8.7/components/best-practices/best-practices-overview.md
index 8974326b568..d0cfbcd4918 100644
--- a/versioned_docs/version-8.7/components/best-practices/best-practices-overview.md
+++ b/versioned_docs/version-8.7/components/best-practices/best-practices-overview.md
@@ -15,108 +15,108 @@ In general, best practices apply to Camunda 8, but there are also some specific
 
 ## Project management Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/management/following-the-customer-success-path/", label: "The Customer Success Path", docId:"components/best-practices/management/following-the-customer-success-path"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/management/following-the-customer-success-path/", label: "The Customer Success Path", docId:"components/best-practices/management/following-the-customer-success-path"},
 {
-type:"link", href:"/docs/next/components/best-practices/management/doing-a-proper-poc/", label: "Proper POC Execution", docId:"components/best-practices/management/doing-a-proper-poc"
+type:"link", href:"/docs/8.7/components/best-practices/management/doing-a-proper-poc/", label: "Proper POC Execution", docId:"components/best-practices/management/doing-a-proper-poc"
 }
 ]}/>
 
 ## Architecture Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/deciding-about-your-stack/", label: "Choosing Your Tech Stack", docId:"components/best-practices/architecture/deciding-about-your-stack"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/architecture/deciding-about-your-stack/", label: "Choosing Your Tech Stack", docId:"components/best-practices/architecture/deciding-about-your-stack"},
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/sizing-your-environment/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment",
+type:"link", href:"/docs/8.7/components/best-practices/architecture/sizing-your-environment/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/understanding-human-tasks-management/", label: "Human Task Management", docId:"components/best-practices/architecture/understanding-human-tasks-management"
+type:"link", href:"/docs/8.7/components/best-practices/architecture/understanding-human-tasks-management/", label: "Human Task Management", docId:"components/best-practices/architecture/understanding-human-tasks-management"
 }
 ]}/>
 
 ## Development Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/development/connecting-the-workflow-engine-with-your-world/", label: "Workflow Engine Integration", docId:"components/best-practices/development/connecting-the-workflow-engine-with-your-world"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/development/connecting-the-workflow-engine-with-your-world/", label: "Workflow Engine Integration", docId:"components/best-practices/development/connecting-the-workflow-engine-with-your-world"},
 {
-type:"link", href:"/docs/next/components/best-practices/development/service-integration-patterns/", label: "Service Integration Patterns", docId:"components/best-practices/development/service-integration-patterns",
+type:"link", href:"/docs/8.7/components/best-practices/development/service-integration-patterns/", label: "Service Integration Patterns", docId:"components/best-practices/development/service-integration-patterns",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/writing-good-workers/", label: "Writing Effective Workers", docId:"components/best-practices/development/writing-good-workers",
+type:"link", href:"/docs/8.7/components/best-practices/development/writing-good-workers/", label: "Writing Effective Workers", docId:"components/best-practices/development/writing-good-workers",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/dealing-with-problems-and-exceptions/", label: "Problems and Exceptions", docId:"components/best-practices/development/dealing-with-problems-and-exceptions",
+type:"link", href:"/docs/8.7/components/best-practices/development/dealing-with-problems-and-exceptions/", label: "Problems and Exceptions", docId:"components/best-practices/development/dealing-with-problems-and-exceptions",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/handling-data-in-processes/", label: "Data Handling in Processes", docId:"components/best-practices/development/handling-data-in-processes",
+type:"link", href:"/docs/8.7/components/best-practices/development/handling-data-in-processes/", label: "Data Handling in Processes", docId:"components/best-practices/development/handling-data-in-processes",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/routing-events-to-processes/", label: "Routing Events to Processes", docId:"components/best-practices/development/routing-events-to-processes",
+type:"link", href:"/docs/8.7/components/best-practices/development/routing-events-to-processes/", label: "Routing Events to Processes", docId:"components/best-practices/development/routing-events-to-processes",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/testing-process-definitions/", label: "Testing Process Definitions", docId:"components/best-practices/development/testing-process-definitions"
+type:"link", href:"/docs/8.7/components/best-practices/development/testing-process-definitions/", label: "Testing Process Definitions", docId:"components/best-practices/development/testing-process-definitions"
 }
 ]}/>
 
 ## Modeling Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/modeling/creating-readable-process-models/", label: "Readable Process Models", docId:"components/best-practices/modeling/creating-readable-process-models"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/modeling/creating-readable-process-models/", label: "Readable Process Models", docId:"components/best-practices/modeling/creating-readable-process-models"},
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/naming-bpmn-elements/", label: "Naming BPMN Elements", docId:"components/best-practices/modeling/naming-bpmn-elements",
+type:"link", href:"/docs/8.7/components/best-practices/modeling/naming-bpmn-elements/", label: "Naming BPMN Elements", docId:"components/best-practices/modeling/naming-bpmn-elements",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/naming-technically-relevant-ids/", label: "Technically Relevant IDs", docId:"components/best-practices/modeling/naming-technically-relevant-ids",
+type:"link", href:"/docs/8.7/components/best-practices/modeling/naming-technically-relevant-ids/", label: "Technically Relevant IDs", docId:"components/best-practices/modeling/naming-technically-relevant-ids",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/modeling-beyond-the-happy-path/", label: "Model Beyond the Happy Path", docId:"components/best-practices/modeling/modeling-beyond-the-happy-path",
+type:"link", href:"/docs/8.7/components/best-practices/modeling/modeling-beyond-the-happy-path/", label: "Model Beyond the Happy Path", docId:"components/best-practices/modeling/modeling-beyond-the-happy-path",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/modeling-with-situation-patterns/", label: "Situation Patterns", docId:"components/best-practices/modeling/modeling-with-situation-patterns",
+type:"link", href:"/docs/8.7/components/best-practices/modeling/modeling-with-situation-patterns/", label: "Situation Patterns", docId:"components/best-practices/modeling/modeling-with-situation-patterns",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/building-flexibility-into-bpmn-models/", label: "Building Flexibility in BPMN", docId:"components/best-practices/modeling/building-flexibility-into-bpmn-models",
+type:"link", href:"/docs/8.7/components/best-practices/modeling/building-flexibility-into-bpmn-models/", label: "Building Flexibility in BPMN", docId:"components/best-practices/modeling/building-flexibility-into-bpmn-models",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/modeling/choosing-the-dmn-hit-policy/", label: "Choosing DMN Hit Policy", docId:"components/best-practices/modeling/choosing-the-dmn-hit-policy"
+type:"link", href:"/docs/8.7/components/best-practices/modeling/choosing-the-dmn-hit-policy/", label: "Choosing DMN Hit Policy", docId:"components/best-practices/modeling/choosing-the-dmn-hit-policy"
 }
 ]}/>
 
 ## Operations Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/operations/versioning-process-definitions/", label: "Versioning Process Definitions", docId:"components/best-practices/operations/versioning-process-definitions"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/operations/versioning-process-definitions/", label: "Versioning Process Definitions", docId:"components/best-practices/operations/versioning-process-definitions"},
 {
-type:"link", href:"/docs/next/components/best-practices/operations/reporting-about-processes/", label: "Process Reporting", docId:"components/best-practices/operations/reporting-about-processes"
+type:"link", href:"/docs/8.7/components/best-practices/operations/reporting-about-processes/", label: "Process Reporting", docId:"components/best-practices/operations/reporting-about-processes"
 }
 ]}/>
 
 ## Camunda 7-specific Best Practices
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/deciding-about-your-stack-c7/", label: "Tech Stack Decisions", docId:"components/best-practices/architecture/deciding-about-your-stack-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/architecture/deciding-about-your-stack-c7/", label: "Tech Stack Decisions", docId:"components/best-practices/architecture/deciding-about-your-stack-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/architecture/sizing-your-environment-c7/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment-c7"
+type:"link", href:"/docs/8.7/components/best-practices/architecture/sizing-your-environment-c7/", label: "Environment Sizing", docId:"components/best-practices/architecture/sizing-your-environment-c7"
 }
 ]}/>
 
 ### Development
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/development/invoking-services-from-the-process-c7/", label: "Service Invocation", docId:"components/best-practices/development/invoking-services-from-the-process-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/development/invoking-services-from-the-process-c7/", label: "Service Invocation", docId:"components/best-practices/development/invoking-services-from-the-process-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/development/understanding-transaction-handling-c7/", label: "Transaction Handling", docId:"components/best-practices/development/understanding-transaction-handling-c7"
+type:"link", href:"/docs/8.7/components/best-practices/development/understanding-transaction-handling-c7/", label: "Transaction Handling", docId:"components/best-practices/development/understanding-transaction-handling-c7"
 },
 {
-type:"link", href:"/docs/next/components/best-practices/development/testing-process-definitions-c7/", label: "Testing process definitions in Camunda 7", docId:"components/best-practices/development/testing-process-definitions-c7"
+type:"link", href:"/docs/8.7/components/best-practices/development/testing-process-definitions-c7/", label: "Testing process definitions in Camunda 7", docId:"components/best-practices/development/testing-process-definitions-c7"
 }
 ]}/>
 
 ### Operations
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/operations/operating-camunda-c7/", label: "Operating Camunda 7", docId:"components/best-practices/operations/operating-camunda-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/operations/operating-camunda-c7/", label: "Operating Camunda 7", docId:"components/best-practices/operations/operating-camunda-c7"},
 {
-type:"link", href:"/docs/next/components/best-practices/operations/performance-tuning-camunda-c7/", label: "Performance Tuning", docId:"components/best-practices/operations/performance-tuning-camunda-c7",
+type:"link", href:"/docs/8.7/components/best-practices/operations/performance-tuning-camunda-c7/", label: "Performance Tuning", docId:"components/best-practices/operations/performance-tuning-camunda-c7",
 },
 {
-type:"link", href:"/docs/next/components/best-practices/operations/securing-camunda-c7/", label: "Securing Camunda 7", docId:"components/best-practices/operations/securing-camunda-c7"
+type:"link", href:"/docs/8.7/components/best-practices/operations/securing-camunda-c7/", label: "Securing Camunda 7", docId:"components/best-practices/operations/securing-camunda-c7"
 }
 ]}/>
 
 ### Other
 
-<DocCardList items={[{type:"link", href:"/docs/next/components/best-practices/architecture/extending-human-task-management-c7/", label: "Extending Human Task Management", docId:"components/best-practices/architecture/extending-human-task-management-c7"},
+<DocCardList items={[{type:"link", href:"/docs/8.7/components/best-practices/architecture/extending-human-task-management-c7/", label: "Extending Human Task Management", docId:"components/best-practices/architecture/extending-human-task-management-c7"},
 ]}/>