Skip to content

docs(data-migrator): document automatic dependency resolution#8046

Open
tasso94 wants to merge 4 commits intomainfrom
1027-document-auto-dependency-resolution
Open

docs(data-migrator): document automatic dependency resolution#8046
tasso94 wants to merge 4 commits intomainfrom
1027-document-auto-dependency-resolution

Conversation

@tasso94
Copy link
Member

@tasso94 tasso94 commented Feb 24, 2026

Description

related to camunda/camunda-7-to-8-migration-tooling#1027

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.

@github-actions
Copy link
Contributor

github-actions bot commented Feb 24, 2026

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

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

  • docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/history.md
  • docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/limitations.md

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.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR documents the automatic dependency resolution feature in the Data Migrator tool for migrating from Camunda 7 to Camunda 8. The changes explain how the migrator now automatically retries skipped entities to resolve cross-entity-type dependencies, reducing the need for manual intervention with the --retry-skipped flag.

Changes:

  • Documents automatic retry mechanism for handling entity dependencies during migration
  • Adds information about unsupported entity types (CMMN entities and standalone user tasks)
  • Improves formatting consistency with indentation fixes

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/limitations.md Expands the limitations section to document automatic retry behavior for dependency-based skips, adds unsupported entity types, and fixes indentation in the incidents section
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/history.md Updates the error handling section with detailed information about automatic retry mechanism and provides examples of cross-entity-type dependencies

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

yanavasileva
yanavasileva previously approved these changes Feb 25, 2026
Copy link
Contributor

@christinaausley christinaausley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice 🚀 Happy to re-approve or help with merge conflict.

@tasso94
Copy link
Member Author

tasso94 commented Feb 27, 2026

@christinaausley, I realized there was one more detail that I just fixed. Can you review my last change?

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

Labels

8.9.0-alpha5 c7migration Issues related to C7 to C8 migration

Projects

Status: 👀 In Review

Development

Successfully merging this pull request may close these issues.

4 participants