release(8.9): release version 8.9 (the big PR)

.github/actions/muffet/action.yaml

@@ -19,6 +19,11 @@ inputs:
 runs:
   using: composite
   steps:
+    - name: Configure Muffet paths
+      shell: bash
+      run: |
+        echo "MUFFET_DIR=${{ runner.temp }}/muffet/${{ inputs.muffet_version }}" >> "$GITHUB_ENV"
+        echo "MUFFET_ARCHIVE=${{ runner.temp }}/muffet/${{ inputs.muffet_version }}/muffet_linux_amd64.tar.gz" >> "$GITHUB_ENV"
     - name: Echo inputs
       shell: bash
       run: |
@@ -30,16 +35,21 @@ runs:
       uses: actions/cache@v5
       id: tool-cache-muffet
       with:
-        path: /usr/local/bin/muffet
+        path: ${{ runner.temp }}/muffet/${{ inputs.muffet_version }}/muffet
         key: ${{ runner.os }}-tool-cache-muffet-${{ inputs.muffet_version }}
     - name: Setup Muffet
       shell: bash
       if: ${{ steps.tool-cache-muffet.outputs.cache-hit != 'true' }}
       run: |-
-        curl -sSL -o /usr/local/bin/muffet_linux_amd64.tar.gz https://github.com/raviqqe/muffet/releases/download/${{ inputs.muffet_version }}/muffet_linux_amd64.tar.gz
-        tar -xvf /usr/local/bin/muffet_linux_amd64.tar.gz -C /usr/local/bin
-        chmod +x /usr/local/bin/muffet
-        muffet --version
+        mkdir -p "$MUFFET_DIR"
+        curl -sSL -o "$MUFFET_ARCHIVE" https://github.com/raviqqe/muffet/releases/download/${{ inputs.muffet_version }}/muffet_linux_amd64.tar.gz
+        tar -xvf "$MUFFET_ARCHIVE" -C "$MUFFET_DIR"
+        chmod +x "$MUFFET_DIR/muffet"
+        "$MUFFET_DIR/muffet" --version
+    - name: Add Muffet to PATH
+      shell: bash
+      run: |
+        echo "$MUFFET_DIR" >> "$GITHUB_PATH"
     - name: Validate URLs
       shell: bash
       run: |-

.github/workflows/build-docs.yaml

@@ -4,14 +4,10 @@ on: pull_request
 
 jobs:
   build-docs:
-    runs-on: ubuntu-latest
-    env:
-      temporary_link_path: .github/workflows/validate-links
+    runs-on: gcp-core-16-default
+    container: node:24
     steps:
       - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: 24
       - name: Install Dependencies
         run: npm ci
       # Removed because it's causing build issues
@@ -21,6 +17,29 @@ jobs:
         run: npm run build
         env:
           NODE_OPTIONS: --max_old_space_size=8192
+      - name: Upload build
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-build
+          path: build
+          include-hidden-files: true
+  validate-links:
+    runs-on: gcp-core-16-default
+    needs: build-docs
+    env:
+      temporary_link_path: .github/workflows/validate-links
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+      - name: Download build
+        uses: actions/download-artifact@v4
+        with:
+          name: docs-build
+          path: build
+      - name: Install hyperlink
+        run: npm install -g @untitaker/hyperlink
       - name: Check internal links
         uses: untitaker/hyperlink@0.2.0
         with:
@@ -38,7 +57,6 @@ jobs:
         uses: nev7n/wait_for_response@v1
         with:
           url: ${{ env.domain_to_test }}
-
       - name: Download sitemap from production
         run: curl -sL https://docs.camunda.io/sitemap.xml | grep -oP '<loc>\K.*?(?=</loc>)' > sitemap.prod.txt
       - name: Remove known broken anchors.

.github/workflows/check-versions/version-config.json

@@ -1,12 +1,12 @@
 [
   {
-    "version": "8.9 (next)",
+    "version": "8.10 (next)",
     "source": "docs/",
-    "suggestions": ["versioned_docs/version-8.8/"]
+    "suggestions": ["versioned_docs/version-8.9/"]
   },
   {
-    "version": "8.8 (current)",
-    "source": "versioned_docs/version-8.8/",
+    "version": "8.9 (current)",
+    "source": "versioned_docs/version-8.9/",
     "suggestions": ["docs/"]
   }
 ]

connectors-element-template-links.txt

@@ -52,7 +52,6 @@ https://docs.camunda.io/docs/components/connectors/out-of-the-box-connectors/ama
 https://docs.camunda.io/docs/components/connectors/out-of-the-box-connectors/amazon-sqs/
 https://docs.camunda.io/docs/components/connectors/out-of-the-box-connectors/amazon-sqs/?amazonsqs=inbound
 https://docs.camunda.io/docs/components/connectors/out-of-the-box-connectors/amazon-sqs/?amazonsqs=outbound
-https://docs.camunda.io/docs/components/connectors/out-of-the-box-connectors/amazon-textract/#execution-types
 https://docs.camunda.io/docs/components/connectors/out-of-the-box-connectors/asana
 https://docs.camunda.io/docs/components/connectors/out-of-the-box-connectors/automation-anywhere
 https://docs.camunda.io/docs/components/connectors/out-of-the-box-connectors/automation-anywhere/

docs/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md

@@ -6,7 +6,7 @@ description: "Understand and decide on the architecture of your task application
 
 A typical task application architecture consists of a task application frontend, a backend-for-frontend, and one or more data sources or services that contain business data relevant for the application users to perform their work. The backend implements Camunda Zeebe and Tasklist clients to retrieve and interact with tasks via Camunda APIs. For historical process instance data, Operate is also required.
 
-Depending on the user task implementation type (job worker-based vs Camunda user task) you use in your processes, you need to run either the Tasklist or Zeebe client to run operations on tasks. Task, form, and variable retrieval happens via the API. Learn more about the differences of the task implementation types in the [migration guide for Camunda user tasks](/versioned_docs/version-8.8/apis-tools/migration-manuals/migrate-to-camunda-user-tasks.md).
+Depending on the user task implementation type (job worker-based vs Camunda user task) you use in your processes, you need to run either the Tasklist or Zeebe client to run operations on tasks. Task, form, and variable retrieval happens via the API. Learn more about the differences of the task implementation types in the [migration guide for Camunda user tasks](/apis-tools/migration-manuals/migrate-to-camunda-user-tasks.md).
 
 :::tip
 Starting a new project? Use Camunda user tasks to simplify your implementation.

docs/components/console/job-dashboard/job-dashboard.md

@@ -169,4 +169,4 @@ In this case, contact your organization owner or admin to request the necessary
 The Console UI and flows are the same in SaaS and Self-Managed.
 
 - **SaaS:** The job dashboard is available for Camunda 8.9+ clusters. Camunda manages the underlying job metrics configuration.
-- **Self-Managed:** You enable and configure job metrics in the engine and Helm charts. For details on available options and defaults, see the job metrics [configuration reference](../../../../self-managed/components/orchestration-cluster/core-settings/configuration/properties).
+- **Self-Managed:** You enable and configure job metrics in the engine and Helm charts. For details on available options and defaults, see the job metrics [configuration reference](../../../self-managed/components/orchestration-cluster/core-settings/configuration/properties.md).

docs/reference/announcements-release-notes/860/860-release-notes.md

@@ -17,7 +17,7 @@ These release notes identify the new features included in 8.6, including [alpha
 
 ### Spring Zeebe SDK - Spring-Boot 3.5 support
 
-As the [Spring-Boot OSS Support](https://spring.io/projects/spring-boot#support) for the bundled Spring-Boot version 3.4 ends in in 2025-12, [Spring-Boot 3.5.x compatibility](../../../../versioned_docs/version-8.6/apis-tools/spring-zeebe-sdk/getting-started.md#version-compatibility) is verfied since the `8.6.30` patch onward.
+As the [Spring-Boot OSS Support](https://spring.io/projects/spring-boot#support) for the bundled Spring-Boot version 3.4 ends in in 2025-12, [Spring-Boot 3.5.x compatibility](../../../../versioned_docs/version-8.6/apis-tools/spring-zeebe-sdk/getting-started.md#version-compatibility) is verified since the `8.6.30` patch onward.
 
 ## 8.6.7
 

docs/reference/announcements-release-notes/870/870-release-notes.md

@@ -17,7 +17,7 @@ These release notes identify the new features included in 8.7, including [alpha
 
 ### Spring Zeebe SDK - Spring-Boot 3.5 support
 
-As the [Spring-Boot OSS Support](https://spring.io/projects/spring-boot#support) for the bundled Spring-Boot version 3.4 ends in in 2025-12, [Spring-Boot 3.5.x compatibility](../../../../versioned_docs/version-8.7/apis-tools/spring-zeebe-sdk/getting-started.md#version-compatibility) is verfied since the `8.7.17` patch onward.
+As the [Spring-Boot OSS Support](https://spring.io/projects/spring-boot#support) for the bundled Spring-Boot version 3.4 ends in in 2025-12, [Spring-Boot 3.5.x compatibility](../../../../versioned_docs/version-8.7/apis-tools/spring-zeebe-sdk/getting-started.md#version-compatibility) is verified since the `8.7.17` patch onward.
 
 ## 8.7 minor
 

docs/self-managed/upgrade/index.md

@@ -89,18 +89,18 @@ Each guide covers only the changes required for that specific version upgrade.
 
 ### Kubernetes with Helm
 
-- <a href="../../../self-managed/upgrade/helm" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.7 to 8.8</a>
-- <a href="../../../8.7/self-managed/setup/upgrade" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.6 to 8.7</a>
-- <a href="../../../8.6/self-managed/setup/upgrade" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.5 to 8.6</a>
+- <a href="/docs/self-managed/upgrade/helm/" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.7 to 8.8</a>
+- <a href="/docs/8.7/self-managed/setup/upgrade/" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.6 to 8.7</a>
+- <a href="/docs/8.6/self-managed/setup/upgrade/" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.5 to 8.6</a>
 - <a href="https://unsupported.docs.camunda.io/8.5/docs/self-managed/setup/upgrade/" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.4 to 8.5</a>
 - <a href="https://unsupported.docs.camunda.io/8.4/docs/self-managed/platform-deployment/helm-kubernetes/upgrade/" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.3 to 8.4</a>
 - <a href="https://unsupported.docs.camunda.io/8.3/docs/self-managed/platform-deployment/helm-kubernetes/upgrade/" target="_blank" rel="noopener noreferrer">Upgrade from Camunda 8.2 to 8.3</a>
 
 ### Component-based upgrades
 
-- <a href="../../../self-managed/upgrade/components" target="_blank" rel="noopener noreferrer">Component upgrade from 8.7 to 8.8</a>
-- <a href="../../../8.7/self-managed/operational-guides/update-guide/860-to-870" target="_blank" rel="noopener noreferrer">Component upgrade from 8.6 to 8.7</a>
-- <a href="../../../8.6/self-managed/operational-guides/update-guide/850-to-860" target="_blank" rel="noopener noreferrer">Component upgrade from 8.5 to 8.6</a>
+- <a href="/docs/self-managed/upgrade/components/" target="_blank" rel="noopener noreferrer">Component upgrade from 8.7 to 8.8</a>
+- <a href="/docs/8.7/self-managed/operational-guides/update-guide/860-to-870/" target="_blank" rel="noopener noreferrer">Component upgrade from 8.6 to 8.7</a>
+- <a href="/docs/8.6/self-managed/operational-guides/update-guide/850-to-860/" target="_blank" rel="noopener noreferrer">Component upgrade from 8.5 to 8.6</a>
 - <a href="https://unsupported.docs.camunda.io/8.5/docs/self-managed/operational-guides/update-guide/840-to-850/" target="_blank" rel="noopener noreferrer">Component upgrade from 8.4 to 8.5</a>
 - <a href="https://unsupported.docs.camunda.io/8.5/docs/self-managed/operational-guides/update-guide/830-to-840/" target="_blank" rel="noopener noreferrer">Component upgrade from 8.3 to 8.4</a>
 - <a href="https://unsupported.docs.camunda.io/8.5/docs/self-managed/operational-guides/update-guide/820-to-830/" target="_blank" rel="noopener noreferrer">Component upgrade from 8.2 to 8.3</a>

docusaurus.config.js

@@ -557,7 +557,10 @@ module.exports = {
           // 👋 When cutting a new version, remove the banner for maintained versions by adding an entry. Remove the entry to versions >18 months old.
           versions: {
             current: {
-              label: "8.9 (unreleased)",
+              label: "8.10 (unreleased)",
+            },
+            8.8: {
+              banner: "none",
             },
             8.7: {
               banner: "none",
@@ -581,6 +584,7 @@ module.exports = {
             "/docs/next/**",
             "/docs/8.6/**",
             "/docs/8.7/**",
+            "/docs/8.8/**",
           ],
         },
       },

hacks/cutNewVersions.sh

@@ -2,9 +2,9 @@
 set -e
 
 # Before running this script make sure these versions are correct!
-NEW_DOCS_VERSION="8.8"
-PREVIOUS_DOCS_VERSION="8.7"
-NEW_NEXT_DOCS_VERSION="8.9"
+NEW_DOCS_VERSION="8.9"
+PREVIOUS_DOCS_VERSION="8.8"
+NEW_NEXT_DOCS_VERSION="8.10"
 
 echo "1/4 Creating version $NEW_DOCS_VERSION of main docs..."
 npm run docusaurus docs:version $NEW_DOCS_VERSION

howtos/documentation-guidelines.md

@@ -33,10 +33,10 @@ In the spirit of "Always Progress," if you are confident you know what change ne
 
 Different versions are sourced from different paths:
 
-| Instance | Version(s)         | Source path                                       |
-| -------- | ------------------ | ------------------------------------------------- |
-| `docs`   | Next               | [/docs/](../docs/)                                |
-| `docs`   | 8.8, 8.7, 8.6, ... | [/versioned_docs/version-\*/](../versioned_docs/) |
+| Instance | Version(s)              | Source path                                       |
+| -------- | ----------------------- | ------------------------------------------------- |
+| `docs`   | Next                    | [/docs/](../docs/)                                |
+| `docs`   | 8.9, 8.8, 8.7, 8.6, ... | [/versioned_docs/version-\*/](../versioned_docs/) |
 
 When edits are intended to apply to both the current version _and beyond_, they should be made in both the most recent versioned folder and the "Next" version folder.
 

howtos/versioning.md

@@ -6,10 +6,10 @@ Our documentation is versioned. All sections are versioned together, this includ
 
 Depending on the version, location of source files and sidebar navigation definition varies:
 
-| Instance | Version(s)         | Source path                                       | Sidebars path                                                         |
-| -------- | ------------------ | ------------------------------------------------- | --------------------------------------------------------------------- |
-| `docs`   | Next               | [/docs/](../docs/)                                | [sidebars.js](../sidebars.js)                                         |
-| `docs`   | 8.8, 8.7, 8.6, ... | [/versioned_docs/version-\*/](../versioned_docs/) | [versioned_sidebars/version-\*-sidebars.json](../versioned_sidebars/) |
+| Instance | Version(s)              | Source path                                       | Sidebars path                                                         |
+| -------- | ----------------------- | ------------------------------------------------- | --------------------------------------------------------------------- |
+| `docs`   | Next                    | [/docs/](../docs/)                                | [sidebars.js](../sidebars.js)                                         |
+| `docs`   | 8.9, 8.8, 8.7, 8.6, ... | [/versioned_docs/version-\*/](../versioned_docs/) | [versioned_sidebars/version-\*-sidebars.json](../versioned_sidebars/) |
 
 ## Create new version
 

src/pages/index.js

@@ -188,21 +188,21 @@ function Home() {
                   styles.getStarted
                 )}
                 to={useBaseUrl(
-                  "docs/reference/announcements-release-notes/880/whats-new-in-88/"
+                  "docs/reference/announcements-release-notes/890/whats-new-in-89/"
                 )}
               >
-                What's new in 8.8
+                What's new in 8.9
               </Link>
               <Link
                 className={clsx(
                   "button button--outline button--secondary button--lg button--hero get-started-use-case get-started-use-case-2",
                   styles.getStarted
                 )}
                 to={useBaseUrl(
-                  "docs/reference/announcements-release-notes/880/880-release-notes/"
+                  "docs/reference/announcements-release-notes/890/890-release-notes/"
                 )}
               >
-                8.8 release notes
+                8.9 release notes
               </Link>
               <Link
                 className={clsx(

src/versions.js

@@ -8,7 +8,7 @@
  * @property {string} urlSuffix
  */
 
-const currentVersion = "8.8";
+const currentVersion = "8.9";
 
 /** @type {Array<UnmaintainedVersion>} */
 const unmaintainedVersions = [