Skip to content

Conversation

@zaycodes
Copy link
Contributor

@zaycodes zaycodes commented Feb 2, 2026

Description

Improves the structure and clarity of the Camunda 8.8 upgrade documentation, aligning the main and component-level upgrade guides with best practices and a clearer user upgrade flow.

Closes #7617

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
  • This is already available but undocumented and should be released within a week. (add available & undocumented label)
  • This is on a specific schedule and the assignee will coordinate a release with the Documentation team. (create draft PR and/or add hold label)
  • This is part of a scheduled alpha or minor. (add alpha or minor label)
  • There is no urgency with this change (add low prio label)

PR Checklist

  • My changes are for an upcoming minor release and are in the /docs directory (version 8.9).

  • My changes are for an already released minor and are in a /versioned_docs directory.

  • I included my new page in the sidebar file(s).

  • I added a redirect for a renamed or deleted page to the .htaccess file.

  • I added a DRI, team, or delegate as a reviewer for technical accuracy and grammar/style:

@zaycodes zaycodes requested review from a team, hisImminence and mlowe-camunda February 2, 2026 14:20
@zaycodes zaycodes self-assigned this Feb 2, 2026
@zaycodes zaycodes added component:docs Documentation improvements, including new or updated content component:self-managed Docs and issues related to Camunda Platform 8 Self-Managed self-managed:helm Helm topics in the Self-Managed domain labels Feb 2, 2026
@zaycodes zaycodes added the deploy Stand up a temporary docs site with this PR label Feb 2, 2026
@camunda-docs-pr-automation camunda-docs-pr-automation bot moved this to 👀 In Review in Documentation Team Feb 2, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Feb 2, 2026

👋 🤖 🤔 Hello, @zaycodes! Did you make your changes in all the right places?

These files were changed only in versioned_docs/version-8.8/. You might want to duplicate these changes in docs/.

  • versioned_docs/version-8.8/apis-tools/migration-manuals/index.md
  • versioned_docs/version-8.8/reference/announcements-release-notes/860/860-announcements.md
  • versioned_docs/version-8.8/reference/announcements-release-notes/860/860-release-notes.md
  • versioned_docs/version-8.8/reference/announcements-release-notes/870/870-announcements.md
  • versioned_docs/version-8.8/reference/announcements-release-notes/870/870-release-notes.md
  • versioned_docs/version-8.8/reference/announcements-release-notes/880/880-announcements.md
  • versioned_docs/version-8.8/reference/announcements-release-notes/880/whats-new-in-88.md
  • versioned_docs/version-8.8/reference/announcements-release-notes/overview.md
  • versioned_docs/version-8.8/reference/announcements-release-notes/release-policy.md
  • versioned_docs/version-8.8/self-managed/about-self-managed.md
  • versioned_docs/version-8.8/self-managed/components/components-upgrade/830-to-840.md
  • versioned_docs/version-8.8/self-managed/components/components-upgrade/840-to-850.md
  • versioned_docs/version-8.8/self-managed/components/components-upgrade/850-to-860.md
  • versioned_docs/version-8.8/self-managed/components/components-upgrade/860-to-870.md
  • versioned_docs/version-8.8/self-managed/components/components-upgrade/elasticsearch/7-to-8.md
  • versioned_docs/version-8.8/self-managed/components/components-upgrade/introduction.md
  • versioned_docs/version-8.8/self-managed/components/components-upgrade/keycloak/keycloak-update.md
  • versioned_docs/version-8.8/self-managed/components/management-identity/configuration/configure-external-identity-provider.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/3.10-to-3.11_8.3.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/3.11_8.3-to-3.12_8.4.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/3.12_8.4-to-3.13_8.5.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/3.13_8.5-to-8.6.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/3.7-to-3.8.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/3.8-to-3.9-preview.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/3.9-preview-to-3.9.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/3.9-to-3.10.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/8.6-to-8.7.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/8.7-to-8.8.md
  • versioned_docs/version-8.8/self-managed/components/optimize/migration-update/camunda-8/instructions.md
  • versioned_docs/version-8.8/self-managed/components/orchestration-cluster/core-settings/migration/importer.md
  • versioned_docs/version-8.8/self-managed/components/orchestration-cluster/zeebe/operations/backups.md
  • versioned_docs/version-8.8/self-managed/components/orchestration-cluster/zeebe/operations/update-zeebe.md
  • versioned_docs/version-8.8/self-managed/concepts/elasticsearch-privileges.md
  • versioned_docs/version-8.8/self-managed/concepts/elasticsearch-without-cluster-privileges.md
  • versioned_docs/version-8.8/self-managed/concepts/multi-region/dual-region.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/cloud-providers/amazon/amazon-eks/eks-helm.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/cloud-providers/azure/microsoft-aks/aks-helm.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/cloud-providers/openshift/dual-region.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/cloud-providers/openshift/redhat-openshift.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/configure/data-retention.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/configure/enable-additional-components.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/install/production/index.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/upgrade/helm-820-830.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/upgrade/helm-830-840.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/upgrade/helm-840-850.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/upgrade/helm-850-860.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/upgrade/helm-860-870.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/upgrade/helm-870-880-dual-region.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/upgrade/helm-870-880.md
  • versioned_docs/version-8.8/self-managed/deployment/helm/upgrade/index.md
  • versioned_docs/version-8.8/self-managed/deployment/manual/cloud-providers/amazon/aws-ec2.md
  • versioned_docs/version-8.8/self-managed/deployment/manual/upgrade.md
  • versioned_docs/version-8.8/self-managed/deployment/react-components/_card-data.js
  • versioned_docs/version-8.8/self-managed/update/administrators/overview.md
  • versioned_docs/version-8.8/self-managed/update/administrators/prepare-for-update.md
  • versioned_docs/version-8.8/self-managed/update/administrators/react-components/_card-data.js
  • versioned_docs/version-8.8/self-managed/update/administrators/run-update.md
  • versioned_docs/version-8.8/self-managed/upgrade/assets/icon-backup.png
  • versioned_docs/version-8.8/self-managed/upgrade/assets/icon-prereqs.png
  • versioned_docs/version-8.8/self-managed/upgrade/assets/icon-restore.png
  • versioned_docs/version-8.8/self-managed/upgrade/assets/jar.png
  • versioned_docs/version-8.8/self-managed/upgrade/assets/kubernetes.png
  • versioned_docs/version-8.8/self-managed/upgrade/components/870-to-880.md
  • versioned_docs/version-8.8/self-managed/upgrade/components/database/changes-in-elasticsearch-8.md
  • versioned_docs/version-8.8/self-managed/upgrade/components/img/import-complete-metrics.png
  • versioned_docs/version-8.8/self-managed/upgrade/components/importer.md
  • versioned_docs/version-8.8/self-managed/upgrade/components/index.md
  • versioned_docs/version-8.8/self-managed/upgrade/components/keycloak/keycloak-compatibility.md
  • versioned_docs/version-8.8/self-managed/upgrade/components/optimize/870-to-880.md
  • versioned_docs/version-8.8/self-managed/upgrade/components/optimize/changes-in-88.md
  • versioned_docs/version-8.8/self-managed/upgrade/components/optimize/index.md
  • versioned_docs/version-8.8/self-managed/upgrade/components/react-components/_card-data.js
  • versioned_docs/version-8.8/self-managed/upgrade/components/react-components/_card.css
  • versioned_docs/version-8.8/self-managed/upgrade/helm/870-to-880-dual-region.md
  • versioned_docs/version-8.8/self-managed/upgrade/helm/870-to-880.md
  • versioned_docs/version-8.8/self-managed/upgrade/helm/index.md
  • versioned_docs/version-8.8/self-managed/upgrade/manual/assets/_upgrade-card-data.js
  • versioned_docs/version-8.8/self-managed/upgrade/manual/assets/icon-arrow.png
  • versioned_docs/version-8.8/self-managed/upgrade/manual/assets/icon-backup.png
  • versioned_docs/version-8.8/self-managed/upgrade/manual/assets/icon-prereqs.png
  • versioned_docs/version-8.8/self-managed/upgrade/manual/index.md
  • versioned_docs/version-8.8/self-managed/upgrade/overview.md
  • versioned_docs/version-8.8/self-managed/upgrade/prepare-for-upgrade.md
  • versioned_docs/version-8.8/self-managed/upgrade/react-components/_card-data.js
  • versioned_docs/version-8.8/self-managed/upgrade/react-components/_card.css

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

@camunda camunda deleted a comment from github-actions bot Feb 2, 2026
@camunda camunda deleted a comment from github-actions bot Feb 2, 2026
@camunda camunda deleted a comment from github-actions bot Feb 2, 2026
@camunda camunda deleted a comment from github-actions bot Feb 2, 2026
@camunda camunda deleted a comment from github-actions bot Feb 2, 2026
@camunda camunda deleted a comment from github-actions bot Feb 2, 2026
@github-actions github-actions bot temporarily deployed to camunda-docs February 2, 2026 14:41 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 3, 2026 22:01 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 6, 2026 21:38 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 8, 2026 20:04 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 9, 2026 13:04 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 9, 2026 13:14 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 9, 2026 14:15 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 9, 2026 17:36 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 10, 2026 12:00 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 10, 2026 12:10 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs February 10, 2026 12:21 Destroyed
@github-actions
Copy link
Contributor

The preview environment relating to the commit cfcd6dc has successfully been deployed. You can access it at https://preview.docs.camunda.cloud/pr-7834/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

component:docs Documentation improvements, including new or updated content component:self-managed Docs and issues related to Camunda Platform 8 Self-Managed deploy Stand up a temporary docs site with this PR self-managed:helm Helm topics in the Self-Managed domain

Projects

Status: 👀 In Review

Development

Successfully merging this pull request may close these issues.

Improve Camunda 8.7 → 8.8 Self-Managed upgrade documentation

2 participants