.htaccess

# Welcome to the redirect party!
#  ____  ____  ____  __  ____  ____  ___  ____    ____   __   ____  ____  _  _  _
# (  _ \(  __)(    \(  )(  _ \(  __)/ __)(_  _)  (  _ \ / _\ (  _ \(_  _)( \/ )/ \
#  )   / ) _)  ) D ( )(  )   / ) _)( (__   )(     ) __//    \ )   /  )(   )  / \_/
# (__\_)(____)(____/(__)(__\_)(____)\___) (__)   (__)  \_/\_/(__\_) (__) (__/  (_)
#
# Please read this guide before adding new redirects.
#
##################################################################################
#
# Redirects in this file are sorted in this order:
#  1. Universal rules that pertain to all content.
#     These redirects have no anticipated removal.
#  2. Broad version (or unversioned) redirects.
#     These redirects have no anticipated removal.
#  3. Specific content moves, in newest-to-oldest order of version in which they are introduced.
#     These redirects will be removed when their introduced version is no longer supported.
#
#  If you're adding a redirect for a specific page or section,
#   you likely want to do that in #3.
#  That means that you want to find the banner comment identifying that version,
#    and add your redirect below that comment.
#
# For help writing rules, see https://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewriterule.
#
##################################################################################

##################################################################################
# 1. Universal rules
##################################################################################

# Redirect to https
RewriteEngine on
RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{SERVER_NAME}/$1 [R=301,L]

# Disable directory listing and multi views
Options -Indexes -MultiViews

# Add yaml mime type
AddType text/vnd.yaml   yaml
# Add bpmn mime type
AddType text/xml        bpmn
# Add graphql scheme mime type
AddType text/plain      graphqls
# Add diff mime type
AddType text/plain      diff

# workaround for 404 with trailing slashes https://github.com/camunda-cloud/camunda-cloud-documentation/issues/403
RewriteRule ^(.*\.(yaml|bpmn|xml|png|jpeg|jpg|yml|pdf|svg|graphqls|diff))/$ /$1 [R=301,L]

##################################################################################
# 2. Broad version (or unversioned) redirects
##################################################################################

# Numbered aliases for vNext. These are temporary, until this version becomes current.
RewriteRule ^docs/8.8/(.*)$ /docs/next/$1 [R=302,L]
RewriteRule ^optimize/3.16.0/(.*)$ /optimize/next/$1 [R=302,L]

# For linking from our apps - redirect URLs with the current version to URLs with no version
RewriteRule ^docs/8.6/(.*)$ /docs/$1 [R=302,L]
RewriteRule ^optimize/3.14.0/(.*)$ /optimize/$1 [R=302,L]

## Archived versions. Note that the URL is adjusted to staging in the publish-stage workflow.
RewriteRule ^docs/0.25/(.*)$ https://unsupported.docs.camunda.io/0.25/docs/$1 [R=301,L]
RewriteRule ^docs/0.26/(.*)$ https://unsupported.docs.camunda.io/0.26/docs/$1 [R=301,L]
RewriteRule ^docs/1.0/(.*)$ https://unsupported.docs.camunda.io/1.0/docs/$1 [R=301,L]
RewriteRule ^docs/1.1/(.*)$ https://unsupported.docs.camunda.io/1.1/docs/$1 [R=301,L]
RewriteRule ^docs/1.2/(.*)$ https://unsupported.docs.camunda.io/1.2/docs/$1 [R=301,L]
RewriteRule ^docs/1.3/(.*)$ https://unsupported.docs.camunda.io/1.3/docs/$1 [R=301,L]
RewriteRule ^optimize/3.7.0/(.*)$ https://unsupported.docs.camunda.io/1.3/optimize/$1 [R=301,L]
RewriteRule ^docs/8.0/(.*)$ https://unsupported.docs.camunda.io/8.0/docs/$1 [R=301,L]
RewriteRule ^optimize/3.8.0/(.*)$ https://unsupported.docs.camunda.io/8.0/optimize/$1 [R=301,L]
RewriteRule ^docs/8.1/(.*)$ https://unsupported.docs.camunda.io/8.1/docs/$1 [R=301,L]
RewriteRule ^optimize/3.9.0/(.*)$ https://unsupported.docs.camunda.io/8.1/optimize/$1 [R=301,L]
RewriteRule ^docs/8.2/(.*)$ https://unsupported.docs.camunda.io/8.2/docs/$1 [R=301,L]
RewriteRule ^optimize/3.10.0/(.*)$ https://unsupported.docs.camunda.io/8.2/optimize/$1 [R=301,L]

# Timeless classics.
# rules required after update to docusaurs 2.0.0-beta.15 see https://github.com/camunda-cloud/camunda-cloud-documentation/pull/531
## index pages are not served as /index/ anymore but /index.html
RewriteRule ^(.*)/index/$ /$1 [R=301,L]
## tags do not exist anymore, redirect to main page
RewriteRule ^(.*)/tags/$ / [R=301,L]
## duplicate sections at the end where removed
RewriteRule ^(.*)/(.+)/\2/?$ /$1/$2 [R=301,L]
# disabled blog, redirect to index page.
RewriteRule ^blog/ / [R=301,L]

# Product links that need to be preserved for Desktop Modeler, in perpetuity.
RewriteRule ^docs/guides/migrating-from-Camunda-Platform/?(.*)$ /docs/guides/migrating-from-camunda-7/$1 [R=301,L]
RewriteRule ^docs/reference/bpmn-processes/?(.*)$ /docs/components/modeler/bpmn/$1 [R=301,L]

# URLs that need to be preserved for connector element templates, in perpetuity.
RewriteRule ^docs/?$ / [R=301,L]
RewriteRule ^docs/apis-clients/operate-api/?$ /docs/apis-tools/operate-api/overview/ [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-dynamodb/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-dynamodb/ [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-eventbridge/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-eventbridge/ [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-eventbridge-webhook/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-eventbridge/?awseventbridge=inbound [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-sns/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-sns/ [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-sns-inbound/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-sns/?amazonsns=inbound [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-sqs/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-sqs/ [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-sqs-inbound/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-sqs/?amazonsqs=inbound [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/github-webhook/?$ /docs/components/connectors/out-of-the-box-connectors/github/?github=inbound [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/kafka-inbound/?$ /docs/components/connectors/out-of-the-box-connectors/kafka/?kafka=inbound [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/rabbitmq-inbound/?$ /docs/components/connectors/out-of-the-box-connectors/rabbitmq/?rabbitmq=inbound [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/rest/?$ /docs/components/connectors/protocol/rest/ [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/slack-inbound/?$ /docs/components/connectors/out-of-the-box-connectors/slack/?slack=inbound [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/twilio-webhook/?$ /docs/components/connectors/out-of-the-box-connectors/twilio/?twilio=inbound [R=301,L]
RewriteCond %{QUERY_STRING} awseventbridge=inbound
RewriteRule ^docs/components/connectors/protocol/amazon-eventbridge/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-eventbridge/?awseventbridge=inbound [R=301,L]
RewriteCond %{QUERY_STRING} awseventbridge=outbound
RewriteRule ^docs/components/connectors/protocol/amazon-eventbridge/?$ /docs/components/connectors/out-of-the-box-connectors/amazon-eventbridge/ [R=301,L]
RewriteRule ^docs/components/connectors/protocol/aws-lambda/?$ /docs/components/connectors/out-of-the-box-connectors/aws-lambda/ [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/graphql/? /docs/components/connectors/protocol/graphql/ [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/http-webhook/? /docs/components/connectors/protocol/http-webhook/ [R=301,L]

RewriteRule ^docs/components/modeler/web-modeler/connectors/available-connectors/automation-anywhere/? /docs/components/connectors/out-of-the-box-connectors/automation-anywhere/ [R=301,L]
RewriteRule ^docs/components/modeler/web-modeler/connectors/available-connectors/rest/? /docs/components/connectors/protocol/rest/ [R=301,L]
RewriteRule ^docs/components/modeler/web-modeler/connectors/available-connectors/sendgrid/? /docs/components/connectors/out-of-the-box-connectors/sendgrid/ [R=301,L]


##################################################################################
# 3. Specific content moves
##################################################################################

# Identity user guide "manage" pages

RewriteRule ^docs/self-managed/identity/user-guide/roles/add-assign-permission/?$ /docs/self-managed/identity/user-guide/roles/manage-permissions/$1 [R=301,L]
RewriteRule ^docs/8.6/self-managed/identity/user-guide/roles/add-assign-permission/?$ /docs/8.6/self-managed/identity/user-guide/roles/manage-permissions/$1 [R=301,L]
RewriteRule ^docs/8.7/self-managed/identity/user-guide/roles/add-assign-permission/?$ /docs/8.7/self-managed/identity/user-guide/roles/manage-permissions/$1 [R=301,L]

RewriteRule ^docs/self-managed/identity/user-guide/groups/create-group/?$ /docs/self-managed/identity/user-guide/groups/manage-groups/$1 [R=301,L]
RewriteRule ^docs/8.6/self-managed/identity/user-guide/groups/create-group/?$ /docs/8.6/self-managed/identity/user-guide/groups/manage-groups/$1 [R=301,L]
RewriteRule ^docs/8.7/self-managed/identity/user-guide/groups/create-group/?$ /docs/8.7/self-managed/identity/user-guide/groups/manage-groups/$1 [R=301,L]

RewriteRule ^docs/self-managed/identity/user-guide/groups/assign-users-roles-to-group/?$ /docs/self-managed/identity/user-guide/groups/manage-users-roles-to-group/$1 [R=301,L]
RewriteRule ^docs/8.6/self-managed/identity/user-guide/groups/assign-users-roles-to-group/?$ /docs/8.6/self-managed/identity/user-guide/groups/manage-users-roles-to-group/$1 [R=301,L]
RewriteRule ^docs/8.7/self-managed/identity/user-guide/groups/assign-users-roles-to-group/?$ /docs/8.7/self-managed/identity/user-guide/groups/manage-users-roles-to-group/$1 [R=301,L]

RewriteRule ^docs/self-managed/identity/user-guide/roles/add-assign-role/?$ /docs/self-managed/identity/user-guide/roles/manage-roles/$1 [R=301,L]
RewriteRule ^docs/8.6/self-managed/identity/user-guide/roles/add-assign-role/?$ /docs/8.6/self-managed/identity/user-guide/roles/manage-roles/$1 [R=301,L]
RewriteRule ^docs/8.7/self-managed/identity/user-guide/roles/add-assign-role/?$ /docs/8.7/self-managed/identity/user-guide/roles/manage-roles/$1 [R=301,L]

# Remove go and zbctl pages, redirect to CCH
RewriteRule ^docs/apis-tools/community-clients/cli-client/(.*)$ https://github.com/camunda-community-hub/zeebe-client-go/blob/main/cmd/zbctl/zbctl.md [R=301,L]
RewriteRule ^docs/apis-tools/community-clients/go-client/(.*)$ https://github.com/camunda-community-hub/zeebe-client-go [R=301,L]
RewriteRule ^docs/8.7/apis-tools/community-clients/cli-client/(.*)$ https://github.com/camunda-community-hub/zeebe-client-go/blob/main/cmd/zbctl/zbctl.md [R=301,L]
RewriteRule ^docs/8.7/apis-tools/community-clients/go-client/(.*)$ https://github.com/camunda-community-hub/zeebe-client-go [R=301,L]
RewriteRule ^docs/8.6/apis-tools/community-clients/cli-client/(.*)$ https://github.com/camunda-community-hub/zeebe-client-go/blob/main/cmd/zbctl/zbctl.md [R=301,L]
RewriteRule ^docs/8.6/apis-tools/community-clients/go-client/(.*)$ https://github.com/camunda-community-hub/zeebe-client-go [R=301,L]

# Remove meta page
RewriteRule ^meta/ / [R=301,L]

# Remove Tasklist GraphQL API in 8.8
RewriteRule ^docs/next/apis-tools/tasklist-api/(.*)$ /docs/next/apis-tools/camunda-api-rest/camunda-api-rest-overview/ [R=301,L]

#---------------------------------------------------------------------------------
#   8.7: content moves introduced prior to the release of version 8.7.
#---------------------------------------------------------------------------------

# Restructure announcements and release notes for 8.6
RewriteRule ^docs/reference/announcements/announcements-850/?$ /docs/reference/announcements-release-notes/850/850-announcements/$1 [R=301,L]
RewriteRule ^docs/reference/release-notes/850/?$ /docs/reference/announcements-release-notes/850/850-release-notes/$1 [R=301,L]
RewriteRule ^docs/reference/announcements/announcements-860/?$ /docs/reference/announcements-release-notes/860/860-announcements/$1 [R=301,L]
RewriteRule ^docs/reference/release-notes/860/?$ /docs/reference/announcements-release-notes/860/860-release-notes/$1 [R=301,L]
RewriteRule ^docs/reference/release-policy/?$ /docs/reference/announcements-release-notes/release-policy/$1 [R=301,L]
RewriteRule ^docs/reference/release-notes/?$ /docs/reference/announcements-release-notes/overview/$1 [R=301,L]
RewriteRule ^docs/reference/announcements/?$ /docs/reference/announcements-release-notes/overview/$1 [R=301,L]

# Restructure announcements and release notes for 8.7
RewriteRule ^docs/8.7/reference/announcements/announcements-850/?$ /docs/8.7/reference/announcements-release-notes/850/850-announcements/$1 [R=301,L]
RewriteRule ^docs/8.7/reference/release-notes/850/?$ /docs/8.7/reference/announcements-release-notes/850/850-release-notes/$1 [R=301,L]
RewriteRule ^docs/8.7/reference/announcements/announcements-860/?$ /docs/8.7/reference/announcements-release-notes/860/860-announcements/$1 [R=301,L]
RewriteRule ^docs/8.7/reference/release-notes/860/?$ /docs/8.7/reference/announcements-release-notes/860/860-release-notes/$1 [R=301,L]
RewriteRule ^docs/8.7/reference/release-notes/870/?$ /docs/8.7/reference/announcements-release-notes/870/870-release-notes/$1 [R=301,L]
RewriteRule ^docs/8.7/reference/release-policy/?$ /docs/8.7/reference/announcements-release-notes/release-policy/$1 [R=301,L]
RewriteRule ^docs/8.7/reference/release-notes/release-notes/?$ /docs/8.7/reference/announcements-release-notes/overview/$1 [R=301,L]
RewriteRule ^docs/8.7/reference/announcements/?$ /docs/8.7/reference/announcements-release-notes/overview/$1 [R=301,L]

# Restructure announcements and release notes for 8.8
RewriteRule ^docs/next/reference/announcements/announcements-850/?$ /docs/next/reference/announcements-release-notes/850/850-announcements/$1 [R=301,L]
RewriteRule ^docs/next/reference/release-notes/850/?$ /docs/next/reference/announcements-release-notes/850/850-release-notes/$1 [R=301,L]
RewriteRule ^docs/next/reference/announcements/announcements-860/?$ /docs/next/reference/announcements-release-notes/860/860-announcements/$1 [R=301,L]
RewriteRule ^docs/next/reference/release-notes/860/?$ /docs/next/reference/announcements-release-notes/860/860-release-notes/$1 [R=301,L]
RewriteRule ^docs/next/reference/release-notes/870/?$ /docs/next/reference/announcements-release-notes/870/870-release-notes/$1 [R=301,L]
RewriteRule ^docs/next/reference/release-policy/?$ /docs/next/reference/announcements-release-notes/release-policy/$1 [R=301,L]
RewriteRule ^docs/next/reference/release-notes/release-notes/?$ /docs/next/reference/announcements-release-notes/overview/$1 [R=301,L]
RewriteRule ^docs/next/reference/announcements/?$ /docs/next/reference/announcements-release-notes/overview/$1 [R=301,L]

# Provide redirects for RPA experimental removal
RewriteRule ^docs/next/components/early-access/experimental/rpa/rpa-framework-library/?$ /docs/next/components/rpa/overview/$1 [R=301,L]
RewriteRule ^docs/next/components/early-access/experimental/rpa/rpa-integration/?$ /docs/next/components/rpa/overview/$1 [R=301,L]
RewriteRule ^docs/8.7/components/early-access/experimental/rpa/rpa-framework-library/?$ /docs/8.7/components/rpa/overview/$1 [R=301,L]
RewriteRule ^docs/8.7/components/early-access/experimental/rpa/rpa-integration/?$ /docs/8.7/components/rpa/overview/$1 [R=301,L]

# Provide current to next redirect for ad-hoc
RewriteRule ^docs/components/modeler/bpmn/ad-hoc/ad-hoc/?$ /docs/8.7/components/modeler/bpmn/ad-hoc-subprocesses/ad-hoc-subprocesses/$1 [R=301,L]
RewriteRule ^docs/components/modeler/bpmn/ad-hoc/?$ /docs/8.7/components/modeler/bpmn/ad-hoc-subprocesses/$1 [R=301,L]

# Rename Web Modeler milestones to versions
RewriteRule ^docs/next/components/modeler/web-modeler/milestones/?$ /docs/next/components/modeler/web-modeler/versions/$1 [R=301,L]

# Send all Optimize 7 content to docs.camunda.org
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/camunda-7/(.*)$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/plugins/(.*)$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/components/userguide/decision-analysis/(.*)$  https://docs.camunda.org/optimize/latest/ [R=301,L]

RewriteRule ^optimize/components/userguide/additional-features/footer/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/components/userguide/additional-features/event-based-processes/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/components/userguide/combined-process-reports/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/version-policy/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/reimport/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/configuration/webhooks/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/configuration/multiple-engines/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/configuration/setup-event-based-processes/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/configuration/system-configuration-platform-7/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/configuration/optimize-license/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/configuration/user-management/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/configuration/authorization-management/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/advanced-features/import-guide/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/advanced-features/engine-data-deletion/?$ https://docs.camunda.org/optimize/latest/ [R=301,L]

# Finalize the renaming of Console SM API to Administration API (Self-Managed)
RewriteRule ^docs/next/apis-tools/administration-sm-api/specifications/sm-administration-api/?$ /docs/next/apis-tools/administration-sm-api/specifications/administration-api-self-managed/ [R=301,L]

# Remove Zeebe REST API
RewriteRule ^docs/next/apis-tools/zeebe-api-rest/specifications/?$ /docs/next/apis-tools/camunda-api-rest/specifications/$1 [R=301,L]
RewriteRule ^docs/next/apis-tools/zeebe-api-rest/zeebe-api-rest-overview/?$ /docs/next/apis-tools/camunda-api-rest/camunda-api-rest-overview/$1 [R=301,L]
RewriteRule ^docs/next/apis-tools/zeebe-api-rest/zeebe-api-rest-authentication/?$ /docs/next/apis-tools/camunda-api-rest/camunda-api-rest-authentication/$1 [R=301,L]
RewriteRule ^docs/next/apis-tools/zeebe-api-rest/zeebe-api-tutorial/?$ /docs/next/apis-tools/camunda-api-rest/camunda-api-rest-overview/$1 [R=301,L]

# Move migrating to Zeebe user tasks
RewriteRule ^docs/next/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks/?$ /docs/next/apis-tools/migration-manuals/migrate-to-camunda-user-tasks/$1 [R=301,L]
RewriteRule ^docs/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks/?$ /docs/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks/$1 [R=301,L]
RewriteRule ^docs/8.6/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks/?$ /docs/8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks/$1 [R=301,L]

# Remove community clients
RewriteRule ^docs/apis-tools/community-clients/c-sharp/?$ /docs/apis-tools/community-clients/$1 [R=301,L]
RewriteRule ^docs/apis-tools/community-clients/micronaut/?$ /docs/apis-tools/community-clients/$1 [R=301,L]
RewriteRule ^docs/apis-tools/community-clients/python/?$ /docs/apis-tools/community-clients/$1 [R=301,L]
RewriteRule ^docs/apis-tools/community-clients/quarkus/?$ /docs/apis-tools/community-clients/$1 [R=301,L]
RewriteRule ^docs/apis-tools/community-clients/ruby/?$ /docs/apis-tools/community-clients/$1 [R=301,L]
RewriteRule ^docs/apis-tools/community-clients/rust/?$ /docs/apis-tools/community-clients/$1 [R=301,L]

# Move contact page
RewriteRule ^contact/?$ /docs/reference/contact/ [R=301,L]

# Remove Connector update guides entirely
RewriteRule ^docs/components/connectors/custom-built-connectors/update-guide/(.*)$ /docs/components/connectors/custom-built-connectors/connector-sdk/ [R=301,L]

# Move alpha features to components
RewriteRule ^docs/next/reference/alpha-features/?$ /docs/next/components/early-access/alpha/alpha-features/$1 [R=301,L]

# Remove outdated message correlation guide
RewriteRule ^docs/next/guides/message-correlation/?$ /docs/guides/$1 [R=301,L]
RewriteRule ^docs/guides/message-correlation/?$ /docs/guides/$1 [R=301,L]
RewriteRule ^docs/8.5/guides/message-correlation/?$ /docs/guides/$1 [R=301,L]

# Remove the Getting Started partials as full pages
RewriteRule ^docs/guides/react-components/sm-prerequisites/?$ /docs/guides/$1 [R=301,L]
RewriteRule ^docs/guides/react-components/saas-prerequisites/?$ /docs/guides/$1 [R=301,L]
RewriteRule ^docs/guides/react-components/install-plain-java/?$ /docs/guides/$1 [R=301,L]
RewriteRule ^docs/guides/react-components/install-docker-compose/?$ /docs/guides/$1 [R=301,L]
RewriteRule ^docs/guides/react-components/install-c8run/?$  /docs/guides/$1 [R=301,L]

# Move logging from troubleshooting to monitoring
RewriteRule ^docs/8.7/self-managed/operational-guides/troubleshooting/log-levels/?$ /docs/8.7/self-managed/operational-guides/monitoring/log-levels/ [R=301,L]
RewriteRule ^docs/8.6/self-managed/operational-guides/troubleshooting/log-levels/?$ /docs/8.6/self-managed/operational-guides/monitoring/log-levels/ [R=301,L]
RewriteRule ^docs/self-managed/operational-guides/troubleshooting/log-levels/?$ /docs/8.6/self-managed/operational-guides/monitoring/log-levels/ [R=301,L]

# Move metrics from zeebe-deployment to monitoring
RewriteRule ^docs/8.7/self-managed/zeebe-deployment/operations/metrics/?$ /docs/8.7/self-managed/operational-guides/monitoring/metrics/ [R=301,L]
RewriteRule ^docs/8.6/self-managed/zeebe-deployment/operations/metrics/?$ /docs/8.6/self-managed/operational-guides/monitoring/metrics/ [R=301,L]
RewriteRule ^docs/self-managed/zeebe-deployment/operations/metrics/?$ /docs/self-managed/operational-guides/monitoring/metrics/ [R=301,L]

# TODO at time of release: account for API spec moves in https://github.com/camunda/camunda-docs/pull/4534 (there are many)

#---------------------------------------------------------------------------------
#   8.6: content moves introduced prior to the release of version 8.6.
#---------------------------------------------------------------------------------

# Move Go and CLI client to community section
RewriteRule ^docs/apis-tools/cli-client/(.*)$ /docs/next/apis-tools/community-clients/cli-client/$1 [R=301,L]
RewriteRule ^docs/apis-tools/go-client/(.*)$ /docs/next/apis-tools/community-clients/go-client/$1 [R=301,L]

# Remove rename, resume, update, and delete a cluster
RewriteRule ^docs/components/console/manage-clusters/rename-cluster/?$ /docs/components/console/manage-clusters/manage-cluster/$1 [R=301,L]
RewriteRule ^docs/components/console/manage-clusters/resume-cluster/?$ /docs/components/console/manage-clusters/manage-cluster/$1 [R=301,L]
RewriteRule ^docs/components/console/manage-clusters/update-cluster/?$ /docs/components/console/manage-clusters/manage-cluster/$1 [R=301,L]
RewriteRule ^docs/components/console/manage-clusters/delete-cluster/?$ /docs/components/console/manage-clusters/manage-cluster/$1 [R=301,L]

RewriteRule ^docs/8.5/components/console/manage-clusters/rename-cluster/?$ /docs/8.5/components/console/manage-clusters/manage-cluster/$1 [R=301,L]
RewriteRule ^docs/8.5/components/console/manage-clusters/resume-cluster/?$ /docs/8.5/components/console/manage-clusters/manage-cluster/$1 [R=301,L]
RewriteRule ^docs/8.5/components/console/manage-clusters/update-cluster/?$ /docs/8.5/components/console/manage-clusters/manage-cluster/$1 [R=301,L]
RewriteRule ^docs/8.5/components/console/manage-clusters/delete-cluster/?$ /docs/8.5/components/console/manage-clusters/manage-cluster/$1 [R=301,L]

# Remove community-supported Spring Zeebe SDK
RewriteRule ^docs/apis-tools/community-clients/spring/?$ /docs/apis-tools/spring-zeebe-sdk/getting-started/$1 [R=301,L]
# Rename Console SM to Administration API (Self-Managed)
RewriteRule ^docs/apis-tools/console-sm-api/(.*)$ /docs/apis-tools/administration-sm-api/$1 [R=301,L]

#remove SM Architecture page
RewriteRule ^docs/self-managed/platform-architecture/overview/?$ /docs/self-managed/about-self-managed/$1 [R=301,L]
RewriteRule ^docs/8.5/self-managed/platform-architecture/overview/?$ /docs/8.5/self-managed/about-self-managed/$1 [R=301,L]
RewriteRule ^docs/8.4/self-managed/platform-architecture/overview/?$ /docs/8.4/self-managed/about-self-managed/$1 [R=301,L]
RewriteRule ^docs/8.3/self-managed/platform-architecture/overview/?$ /docs/8.3/self-managed/about-self-managed/$1 [R=301,L]

# remove tasklist API + Spring Zeebe tutorial
RewriteRule ^docs/apis-tools/tasklist-api-rest/tasklist-api-rest-tutorial/?$ /docs/apis-tools/tasklist-api-rest/tasklist-api-rest-overview/$1 [R=301,L]

# remove unsupported versions
RewriteRule ^docs/self-managed/operational-guides/update-guide/800-to-810/?$ /docs/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/self-managed/operational-guides/update-guide/130-to-800/?$ /docs/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/self-managed/operational-guides/update-guide/810-to-820/?$ /docs/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]

RewriteRule ^docs/8.4/self-managed/operational-guides/update-guide/800-to-810/?$ /docs/8.4/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.4/self-managed/operational-guides/update-guide/130-to-800/?$ /docs/8.4/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.4/self-managed/operational-guides/update-guide/810-to-820/?$ /docs/8.4/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]

RewriteRule ^docs/8.3/self-managed/operational-guides/update-guide/800-to-810/?$ /docs/8.3/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.3/self-managed/operational-guides/update-guide/130-to-800/?$ /docs/8.3/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.3/self-managed/operational-guides/update-guide/810-to-820/?$ /docs/8.3/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]

# redirect new-context-pad to context-pad
RewriteRule ^docs/components/modeler/web-modeler/new-context-pad/?$ /docs/components/modeler/web-modeler/context-pad/$1 [R=301,L]

# Remove Cawemo
RewriteRule ^docs/guides/migrating-from-cawemo/?$ https://docs.camunda.org/enterprise/announcement/#cawemo-saas-announcements [R=301,L]
RewriteRule ^docs/8.4/guides/migrating-from-cawemo/?$ https://docs.camunda.org/enterprise/announcement/#cawemo-saas-announcements [R=301,L]
RewriteRule ^docs/8.3/guides/migrating-from-cawemo/?$ https://docs.camunda.org/enterprise/announcement/#cawemo-saas-announcements [R=301,L]

# Move Help Center
RewriteRule ^docs/guides/camunda-help-center/(.*)$ /docs/reference/camunda-help-center/$1 [R=301,L]
RewriteRule ^docs/8.5/guides/camunda-help-center/(.*)$ /docs/8.5/reference/camunda-help-center/$1 [R=301,L]

# Removing telemetry page
RewriteRule ^optimize/self-managed/optimize-deployment/configuration/telemetry/(.*)$ /optimize/self-managed/optimize-deployment/configuration/getting-started/$1 [R=301,L]

# Remove updating-tasklist pages
RewriteRule ^docs/components/tasklist/userguide/updating-tasklist-cloud/?$ /docs/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.5/components/tasklist/userguide/updating-tasklist-cloud/?$ /docs/8.5/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.4/components/tasklist/userguide/updating-tasklist-cloud/?$ /docs/8.4/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.3/components/tasklist/userguide/updating-tasklist-cloud/?$ /docs/8.3/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]

RewriteRule ^docs/self-managed/tasklist-deployment/updating-tasklist/?$ /docs/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.5/self-managed/tasklist-deployment/updating-tasklist/?$ /docs/8.5/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.4/self-managed/tasklist-deployment/updating-tasklist/?$ /docs/8.4/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.3/self-managed/tasklist-deployment/updating-tasklist/?$ /docs/8.3/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]

# Remove community Node Zeebe page
RewriteRule ^docs/apis-tools/community-clients/javascript/?$ /docs/apis-tools/node-js-sdk/$1 [R=301,L]
RewriteRule ^docs/8.5/apis-tools/community-clients/javascript/?$ /docs/8.5/apis-tools/node-js-sdk/$1 [R=301,L]

# Remove "new web modeler" page, re-route to launch-web-modeler rather than launch-cloud-modeler
RewriteRule ^docs/components/modeler/web-modeler/new-web-modeler/?$ /docs/components/modeler/web-modeler/launch-web-modeler/$1 [R=301,L]
RewriteRule ^docs/8.5/components/modeler/web-modeler/new-web-modeler/?$ /docs/8.5/components/modeler/web-modeler/launch-web-modeler/$1 [R=301,L]
RewriteRule ^docs/8.4/components/modeler/web-modeler/new-web-modeler/?$ /docs/8.4/components/modeler/web-modeler/launch-web-modeler/$1 [R=301,L]
RewriteRule ^docs/8.3/components/modeler/web-modeler/new-web-modeler/?$ /docs/8.3/components/modeler/web-modeler/launch-web-modeler/$1 [R=301,L]
RewriteRule ^docs/components/modeler/web-modeler/launch-cloud-modeler/?$ /docs/components/modeler/web-modeler/launch-web-modeler/$1 [R=301,L]
RewriteRule ^docs/8.5/components/modeler/web-modeler/launch-cloud-modeler/?$ /docs/8.5/components/modeler/web-modeler/launch-web-modeler/$1 [R=301,L]
RewriteRule ^docs/8.4/components/modeler/web-modeler/launch-cloud-modeler/?$ /docs/8.4/components/modeler/web-modeler/launch-web-modeler/$1 [R=301,L]
RewriteRule ^docs/8.3/components/modeler/web-modeler/launch-cloud-modeler/?$ /docs/8.3/components/modeler/web-modeler/launch-web-modeler/$1 [R=301,L]

## optimize splitting of upgrade guides
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/2.1-to-2.2/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.1-to-2.2/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/2.2-to-2.3/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.2-to-2.3/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/2.3-to-2.4/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.3-to-2.4/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/2.4-to-2.5/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.4-to-2.5/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/2.5-to-2.6/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.5-to-2.6/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/2.6-to-2.7/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.6-to-2.7/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/2.7-to-3.0/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.7-to-3.0/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.0-to-3.1/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.0-to-3.1/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.1-to-3.2/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.1-to-3.2/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.2-to-3.3/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.2-to-3.3/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.3-to-3.4/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.3-to-3.4/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.4-to-3.5/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.4-to-3.5/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.5-to-3.6/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.5-to-3.6/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.6-to-3.7/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.6-to-3.7/ [R=301,L]

RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.7-to-3.8/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/3.7-to-3.8/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.8-to-3.9-preview-1/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/3.8-to-3.9-preview-1/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.9-preview-1-to-3.9/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/3.9-preview-1-to-3.9/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.9-to-3.10/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/3.9-to-3.10/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.10-to-3.11_8.3/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/3.10-to-3.11_8.3/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.11_8.3-to-3.12_8.4/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/3.11_8.3-to-3.12_8.4/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.12_8.4-to-3.13_8.5/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/3.12_8.4-to-3.13_8.5/ [R=301,L]
RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/3.13_8.5-to-8.6/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/3.13_8.5-to-8.6/ [R=301,L]

RewriteRule ^optimize/self-managed/optimize-deployment/migration-update/instructions/?$ /optimize/self-managed/optimize-deployment/migration-update/camunda-8/instructions/ [R=301,L]

# Updated web-modeler troubleshooting
RewriteRule ^docs/self-managed/modeler/web-modeler/troubleshooting/troubleshoot-login/?$ /docs/self-managed/modeler/web-modeler/troubleshooting/troubleshoot-missing-data/ [R=301,L]

#---------------------------------------------------------------------------------
#   8.5: content moves introduced prior to the release of version 8.5.
#---------------------------------------------------------------------------------

RewriteRule ^docs/apis-tools/frontend-development/introduction-to-task-applications/?$ /docs/apis-tools/frontend-development/task-applications/introduction-to-task-applications$1 [R=301,L]
RewriteRule ^docs/components/operate/userguide/updating-operate/?$ /docs/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]

# Installation restructure
RewriteRule ^docs/self-managed/platform-deployment/manual/?$ /docs/self-managed/setup/deploy/local/manual/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/docker/?$ /docs/self-managed/setup/deploy/other/docker/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/overview/?$ /docs/self-managed/setup/overview/ [R=301,L]

RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/deploy/?$ /docs/self-managed/setup/overview/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/overview/?$ /docs/self-managed/setup/overview/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/upgrade/?$ /docs/self-managed/setup/upgrade/ [R=301,L]

RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/platforms/?$ /docs/self-managed/setup/overview/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/platforms/amazon/?$ /docs/self-managed/setup/deploy/amazon/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/platforms/amazon-eks(.*)$ /docs/self-managed/setup/deploy/amazon/amazon-eks$1 [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/platforms/google-gke/?$ /docs/self-managed/setup/deploy/gcp/google-gke/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/platforms/microsoft-aks/?$ /docs/self-managed/setup/deploy/azure/microsoft-aks/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/platforms/redhat-openshift/?$ /docs/self-managed/setup/deploy/openshift/redhat-openshift/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/platforms/docker/?$ /docs/self-managed/setup/deploy/other/docker/ [R=301,L]

RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/aws-marketplace/?$ /docs/self-managed/setup/deploy/amazon/aws-marketplace/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/accessing-components-without-ingress/?$ /docs/self-managed/setup/guides/accessing-components-without-ingress/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/air-gapped-installation/?$ /docs/self-managed/setup/guides/air-gapped-installation/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/connect-to-an-oidc-provider/?$ /docs/self-managed/setup/guides/connect-to-an-oidc-provider/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/ingress-setup/?$ /docs/self-managed/setup/guides/ingress-setup/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/multi-namespace-deployment/?$ /docs/self-managed/setup/guides/multi-namespace-deployment/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/running-custom-connectors/?$ /docs/self-managed/setup/guides/running-custom-connectors/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/using-existing-keycloak/?$ /docs/self-managed/setup/guides/using-existing-keycloak/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/?$ /docs/self-managed/setup/guides/ [R=301,L]
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/local-kubernetes-cluster/?$ /docs/self-managed/setup/deploy/local/local-kubernetes-cluster/ [R=301,L]

# Operate API Explorer migrated into versioned docs
RewriteRule ^api/operate/docs/(.*)$ /docs/apis-tools/operate-api/specifications/$1 [R=301,L]
# Tasklist API Explorer migrated into versioned docs
RewriteRule ^api/tasklist/docs/(.*)$ /docs/apis-tools/tasklist-api-rest/specifications/$1 [R=301,L]

# Remove updating-operate pages
RewriteRule ^docs/components/operate/userguide/updating-operate/?$ /docs/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.4/components/operate/userguide/updating-operate/?$ /docs/8.4/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.3/components/operate/userguide/updating-operate/?$ /docs/8.3/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]

RewriteRule ^docs/self-managed/operate-deployment/updating-operate/?$ /docs/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.4/self-managed/operate-deployment/updating-operate/?$ /docs/8.4/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]
RewriteRule ^docs/8.3/self-managed/operate-deployment/updating-operate/?$ /docs/8.3/self-managed/operational-guides/update-guide/introduction/$1 [R=301,L]

# Consolidate SM troubleshooting pages
RewriteRule ^docs/self-managed/platform-deployment/troubleshooting/?$ /docs/self-managed/operational-guides/troubleshooting/$1 [R=301,L]

# Rename whitelist to allowlist
RewriteRule ^docs/components/console/manage-clusters/manage-ip-whitelists/?$ /docs/components/console/manage-clusters/manage-ip-allowlists/$1 [R=301,L]
RewriteRule ^docs/8.4/components/console/manage-clusters/manage-ip-whitelists/?$ /docs/8.4/components/console/manage-clusters/manage-ip-allowlists/$1 [R=301,L]
RewriteRule ^docs/8.3/components/console/manage-clusters/manage-ip-whitelists/?$ /docs/8.3/components/console/manage-clusters/manage-ip-allowlists/$1 [R=301,L]

# Move install-zeebe-exporters
RewriteRule ^docs/self-managed/platform-deployment/helm-kubernetes/guides/install-zeebe-exporters/?$ /docs/self-managed/zeebe-deployment/exporters/install-zeebe-exporters/$1 [R=301,L]
RewriteRule ^docs/8.4/self-managed/platform-deployment/helm-kubernetes/guides/install-zeebe-exporters/?$ /docs/8.4/self-managed/zeebe-deployment/exporters/install-zeebe-exporters/$1 [R=301,L]
RewriteRule ^docs/8.3/self-managed/platform-deployment/helm-kubernetes/guides/install-zeebe-exporters/?$ /docs/8.3/self-managed/zeebe-deployment/exporters/install-zeebe-exporters/$1 [R=301,L]

# Rename Console API
RewriteRule ^docs/apis-tools/console-api/?$ /docs/apis-tools/administration-api/$1 [R=301,L]
RewriteRule ^docs/8.4/apis-tools/console-api/?$ /docs/8.4/apis-tools/administration-api/$1 [R=301,L]
RewriteRule ^docs/apis-tools/console-api/console-api-reference/?$ /docs/apis-tools/administration-api/administration-api-reference/$1 [R=301,L]
RewriteRule ^docs/8.4/apis-tools/console-api/console-api-reference/?$ /docs/8.4/apis-tools/administration-api/administration-api-reference/$1 [R=301,L]
RewriteRule ^docs/8.3/apis-tools/console-api-reference/?$ /docs/8.3/apis-tools/administration-api-reference/$1 [R=301,L]

RewriteRule ^docs/apis-tools/console-api/authentication/?$ /docs/apis-tools/administration-api/authentication/$1 [R=301,L]
RewriteRule ^docs/8.4/apis-tools/console-api/authentication/?$ /docs/8.4/apis-tools/administration-api/authentication/$1 [R=301,L]

# Rename forms element library checkbox
RewriteRule ^docs/components/modeler/forms/form-element-library/forms-element-library-checklist/?$ /docs/components/modeler/forms/form-element-library/forms-element-library-checkbox-group/$1 [R=301,L]
RewriteRule ^docs/8.4/components/modeler/forms/form-element-library/forms-element-library-checklist/?$ /docs/8.4/components/modeler/forms/form-element-library/forms-element-library-checkbox-group/$1 [R=301,L]

# Remove Operate feedback page
RewriteRule ^docs/components/operate/userguide/operate-feedback-and-questions/?$ /contact/$1 [R=301,L]
RewriteRule ^docs/8.4/components/operate/userguide/operate-feedback-and-questions/?$ /contact/$1 [R=301,L]
RewriteRule ^docs/8.3/components/operate/userguide/operate-feedback-and-questions/?$ /contact/$1 [R=301,L]

# Redirect to Connectors overview upon deprecation of Power Automate Connector
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/power-automate/?$ /docs/components/connectors/out-of-the-box-connectors/available-connectors-overview/ [R=301,L]
RewriteRule ^docs/8.4/components/connectors/out-of-the-box-connectors/power-automate/?$ /docs/8.4/components/connectors/out-of-the-box-connectors/available-connectors-overview/ [R=301,L]
RewriteRule ^docs/8.3/components/connectors/out-of-the-box-connectors/power-automate/?$ /docs/8.3/components/connectors/out-of-the-box-connectors/available-connectors-overview/ [R=301,L]

#---------------------------------------------------------------------------------
#   8.4: content moves introduced prior to the release of version 8.4.
#---------------------------------------------------------------------------------

RewriteRule ^docs/apis-tools/web-modeler-api/?$ /docs/apis-tools/web-modeler-api/overview/ [R=301,L]
RewriteRule ^optimize/apis-tools/optimize-api/optimize-api-authorization/(.*)$ /optimize/apis-tools/optimize-api/optimize-api-authentication/$1 [R=301,L]
RewriteRule ^docs/apis-tools/grpc/?$ /docs/apis-tools/zeebe-api/overview/ [R=301,L]
RewriteRule ^docs/apis-tools/console-api-reference/?$ /docs/apis-tools/console-api/console-api-reference/ [R=301,L]
RewriteRule ^optimize/components/userguide/process-analysis/outlier-analysis/?$ /optimize/components/userguide/process-analysis/task-analysis/ [R=301,L]
RewriteRule ^docs/self-managed/identity/troubleshooting/common-problems/?$ /docs/self-managed/identity/troubleshooting/troubleshoot-identity/ [R=301,L]
RewriteRule ^docs/components/operate/userguide/updating-operate-cloud/?$ /docs/self-managed/operate-deployment/updating-operate/ [R=301,L]

# Early access to alpha features
RewriteRule ^docs/reference/early-access/?$ /docs/reference/alpha-features/ [R=301,L]
RewriteRule ^docs/8.3/reference/early-access/?$ /docs/8.3/reference/alpha-features/ [R=301,L]

#---------------------------------------------------------------------------------
#   8.3: content moves introduced prior to the release of version 8.3.
#---------------------------------------------------------------------------------

RewriteRule ^docs/guides/update-guide/connectors/(.*)$ /docs/components/connectors/custom-built-connectors/update-guide/$1 [R=301,L]
RewriteRule ^docs/guides/update-guide/(.*)$ /docs/self-managed/operational-guides/update-guide/$1 [R=301,L]
RewriteRule ^docs/self-managed/backup-restore/(.*)$ /docs/self-managed/operational-guides/backup-restore/$1 [R=301,L]
RewriteRule ^docs/self-managed/troubleshooting/log-levels/(.*)$ /docs/self-managed/operational-guides/troubleshooting/log-levels$1 [R=301,L]

# Condense Connectors
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/amazon-sns-inbound/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-sns/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/amazon-sqs-inbound/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-sqs/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/amazon-eventbridge-webhook/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-eventbridge/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/github-webhook/(.*)$ /docs/components/connectors/out-of-the-box-connectors/github/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/kafka-inbound/(.*)$ /docs/components/connectors/out-of-the-box-connectors/kafka/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/rabbitmq-inbound/(.*)$ /docs/components/connectors/out-of-the-box-connectors/rabbitmq/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/slack-inbound/(.*)$ /docs/components/connectors/out-of-the-box-connectors/slack/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/twilio-webhook/(.*)$ /docs/components/connectors/out-of-the-box-connectors/twilio/$1 [R=301,L]

# Remove public API page
RewriteRule ^docs/apis-tools/public-api/(.*)$ /docs/apis-tools/working-with-apis-tools/$1 [R=301,L]

# Restructure Identity Concepts
RewriteRule ^docs/next/self-managed/concepts/access-control/apis/(.*)$ /docs/next/self-managed/identity/user-guide/additional-features/adding-an-api/$1 [R=301,L]
RewriteRule ^docs/self-managed/concepts/access-control/apis/(.*)$ /docs/self-managed/identity/user-guide/additional-features/adding-an-api/$1 [R=301,L]

RewriteRule ^docs/next/self-managed/concepts/access-control/groups/?(.*)$ /docs/next/self-managed/identity/user-guide/groups/create-group/$1 [R=301,L]
RewriteRule ^docs/self-managed/concepts/access-control/groups/?(.*)$ /docs/self-managed/identity/user-guide/groups/create-group/$1 [R=301,L]

RewriteRule ^docs/next/self-managed/concepts/access-control/roles/?(.*)$ /docs/next/self-managed/identity/user-guide/roles/add-assign-role/$1 [R=301,L]
RewriteRule ^docs/self-managed/concepts/access-control/roles/?(.*)$ /docs/self-managed/identity/user-guide/roles/add-assign-role/$1 [R=301,L]

RewriteRule ^docs/next/self-managed/concepts/access-control/users/?(.*)$ /docs/next/self-managed/identity/user-guide/roles/add-assign-role/$1 [R=301,L]
RewriteRule ^docs/self-managed/concepts/access-control/users/?(.*)$ /docs/self-managed/identity/user-guide/roles/add-assign-role/$1 [R=301,L]

RewriteRule ^docs/next/self-managed/concepts/authentication/m2m-tokens/(.*)$ /docs/next/self-managed/identity/user-guide/authorizations/generating-m2m-tokens/$1 [R=301,L]
RewriteRule ^docs/self-managed/concepts/authentication/m2m-tokens/(.*)$ /docs/self-managed/identity/user-guide/authorizations/generating-m2m-tokens/$1 [R=301,L]

RewriteRule ^docs/next/self-managed/concepts/access-control/permissions/(.*)$ /docs/next/self-managed/identity/user-guide/roles/add-assign-permission/$1 [R=301,L]
RewriteRule ^docs/self-managed/concepts/access-control/permissions/(.*)$ /docs/self-managed/identity/user-guide/roles/add-assign-permission/$1 [R=301,L]

# Remove feedback & support page
RewriteRule ^docs/components/console/console-troubleshooting/feedback-and-support/(.*)$ /contact/$1 [R=301,L]

# Branding redirects
RewriteRule ^docs/next/components/connectors/out-of-the-box-connectors/aws-dynamodb/(.*)$ /docs/next/components/connectors/out-of-the-box-connectors/amazon-dynamodb/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-dynamodb/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-dynamodb/$1 [R=301,L]

RewriteRule ^docs/next/components/connectors/out-of-the-box-connectors/aws-eventbridge/(.*)$ /docs/next/components/connectors/out-of-the-box-connectors/amazon-eventbridge/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-eventbridge/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-eventbridge/$1 [R=301,L]

RewriteRule ^docs/next/components/connectors/out-of-the-box-connectors/aws-eventbridge-webhook/(.*)$ /docs/next/components/connectors/out-of-the-box-connectors/amazon-eventbridge-webhook/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-eventbridge-webhook/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-eventbridge-webhook/$1 [R=301,L]

RewriteRule ^docs/next/components/connectors/out-of-the-box-connectors/aws-sns/(.*)$ /docs/next/components/connectors/out-of-the-box-connectors/amazon-sns/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-sns/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-sns/$1 [R=301,L]

RewriteRule ^docs/next/components/connectors/out-of-the-box-connectors/aws-sns-inbound/(.*)$ /docs/next/components/connectors/out-of-the-box-connectors/amazon-sns-inbound/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-sns-inbound/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-sns-inbound/$1 [R=301,L]

RewriteRule ^docs/next/components/connectors/out-of-the-box-connectors/aws-sqs/(.*)$ /docs/next/components/connectors/out-of-the-box-connectors/amazon-sqs/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-sqs/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-sqs/$1 [R=301,L]

RewriteRule ^docs/next/components/connectors/out-of-the-box-connectors/aws-sqs-inbound/(.*)$ /docs/next/components/connectors/out-of-the-box-connectors/amazon-sqs-inbound/$1 [R=301,L]
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/aws-sqs-inbound/(.*)$ /docs/components/connectors/out-of-the-box-connectors/amazon-sqs-inbound/$1 [R=301,L]

# Remove orphaned Tasklist page
RewriteRule ^docs/next/self-managed/tasklist-deployment/tasklist-api/(.*)$ /docs/next/apis-tools/tasklist-api/tasklist-api-overview/$1 [R=301,L]
RewriteRule ^docs/self-managed/tasklist-deployment/tasklist-api/(.*)$ /docs/apis-tools/tasklist-api/tasklist-api-overview/$1 [R=301,L]

# Rename Modeler Camunda 8
RewriteRule ^docs/next/components/modeler/desktop-modeler/connect-to-camunda-platform-8/(.*)$ /docs/next/components/modeler/desktop-modeler/connect-to-camunda-8/$1 [R=301,L]
RewriteRule ^docs/components/modeler/desktop-modeler/connect-to-camunda-platform-8/(.*)$ /docs/components/modeler/desktop-modeler/connect-to-camunda-8/$1 [R=301,L]

# Rename Concepts Camunda 8
RewriteRule ^docs/next/components/concepts/what-is-camunda-platform-8/(.*)$ /docs/next/components/concepts/what-is-camunda-8/$1 [R=301,L]
RewriteRule ^docs/components/concepts/what-is-camunda-platform-8/(.*)$ /docs/components/concepts/what-is-camunda-8/$1 [R=301,L]

# Renaming Guides
RewriteRule ^docs/guides/migrating-from-camunda-platform-7(.*)$ /docs/guides/migrating-from-camunda-7$1 [R=301,L]
RewriteRule ^docs/next/guides/migrating-from-camunda-platform-7(.*)$ /docs/guides/migrating-from-camunda-7$1 [R=301,L]

# rename Professional Plan to Starter Plan
RewriteRule ^docs/next/components/console/manage-plan/upgrade-to-professional-plan/(.*)$ /docs/next/components/console/manage-plan/upgrade-to-starter-plan/$1 [R=301,L]
RewriteRule ^docs/components/console/manage-plan/upgrade-to-professional-plan/(.*)$ /docs/components/console/manage-plan/upgrade-to-starter-plan/$1 [R=301,L]

RewriteRule ^docs/next/components/console/manage-plan/cancel-professional-subscription/(.*)$ /docs/next/components/console/manage-plan/cancel-starter-subscription/$1 [R=301,L]
RewriteRule ^docs/components/console/manage-plan/cancel-professional-subscription/(.*)$ /docs/components/console/manage-plan/cancel-starter-subscription/$1 [R=301,L]

# rename Desktop Modeler reference to Camunda Cloud
RewriteRule ^docs/next/components/modeler/desktop-modeler/connect-to-camunda-cloud/(.*)$ /docs/next/components/modeler/desktop-modeler/connect-to-camunda-platform-8/$1 [R=301,L]
RewriteRule ^docs/components/modeler/desktop-modeler/connect-to-camunda-cloud/(.*)$ /docs/components/modeler/desktop-modeler/connect-to-camunda-platform-8/$1 [R=301,L]

# API Endpoints to API Orchestration
RewriteRule ^docs/guides/orchestrate-api-endpoints(.*)$ /docs/guides/orchestrate-apis$1 [R=301,L]

# Remove OSS section
RewriteRule ^docs/components/zeebe/open-source(.*)$ /docs/components/zeebe/zeebe-overview/ [R=301,L]

# interceptors
RewriteRule ^docs/self-managed/zeebe-deployment/interceptors(.*)$ /docs/self-managed/zeebe-deployment/zeebe-gateway/interceptors/$1 [R=301,L]

# Console restructure
RewriteRule ^docs/components/console/manage-organization/update-billing-reservations(.*)$ /docs/components/console/manage-plan/update-billing-reservations/$1 [R=301,L]
RewriteRule ^docs/components/console/manage-organization/update-creditcard(.*)$ /docs/components/console/manage-plan/update-creditcard/$1 [R=301,L]

# Connectors TEMPLATE removal
RewriteRule ^docs/components/connectors/out-of-the-box-connectors/template/(.*)$ /docs/components/connectors/out-of-the-box-connectors/available-connectors-overview/$1 [R=301,L]

# Modeler start instance and deploy page renaming and merging
RewriteRule ^docs/components/modeler/web-modeler/start-instance/?$ /docs/components/modeler/web-modeler/run-or-publish-your-process/ [R=301,L]
RewriteRule ^docs/components/modeler/web-modeler/save-and-deploy/?$ /docs/components/modeler/web-modeler/run-or-publish-your-process/#deploy-a-process [R=301,L,NE]
RewriteRule ^docs/next/components/modeler/web-modeler/start-instance/?$ /docs/next/components/modeler/web-modeler/run-or-publish-your-process/ [R=301,L]
RewriteRule ^docs/next/components/modeler/web-modeler/save-and-deploy/?$ /docs/next/components/modeler/web-modeler/run-or-publish-your-process/#deploy-a-process [R=301,L,NE]

# Move user metrics page to a new folder
RewriteRule ^docs/reference/usage-metrics.md/?$ ^docs/reference/data-collection/usage-metrics.md/? [R=301,L,NE]

# Remove Migration to Camunda 8 pages
RewriteRule ^docs/next/guides/migrating-from-camunda-7/adjusting-dmn-models/(.*)$ /docs/next/guides/migrating-from-camunda-7/index/ [R=301,L]
RewriteRule ^docs/8.7/guides/migrating-from-camunda-7/adjusting-dmn-models/(.*)$ /docs/8.7/guides/migrating-from-camunda-7/index/ [R=301,L]
RewriteRule ^docs/guides/migrating-from-camunda-7/adjusting-dmn-models/(.*)$ /docs/guides/migrating-from-camunda-7/index/ [R=301,L]
RewriteRule ^docs/next/guides/migrating-from-camunda-7/adjusting-source-code/(.*)$ /docs/next/guides/migrating-from-camunda-7/index/ [R=301,L]
RewriteRule ^docs/8.7/guides/migrating-from-camunda-7/adjusting-source-code/(.*)$ /docs/8.7/guides/migrating-from-camunda-7/index/ [R=301,L]
RewriteRule ^docs/guides/migrating-from-camunda-7/adjusting-source-code/(.*)$ /docs/guides/migrating-from-camunda-7/index/ [R=301,L]
RewriteRule ^docs/next/guides/migrating-from-camunda-7/adjusting-bpmn-models/(.*)$ /docs/next/guides/migrating-from-camunda-7/index/ [R=301,L]
RewriteRule ^docs/8.7/guides/migrating-from-camunda-7/adjusting-bpmn-models/(.*)$ /docs/8.7/guides/migrating-from-camunda-7/index/ [R=301,L]
RewriteRule ^docs/guides/migrating-from-camunda-7/adjusting-bpmn-models/(.*)$ /docs/guides/migrating-from-camunda-7/index/ [R=301,L]