docs(data-migrator): improve docs

[tasso94]

Description

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

• The commit history of this PR is cleaned up, using {type}(scope): {description} commit message(s)

• 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 added a DRI, team, or delegate as a reviewer for technical accuracy and grammar/style:
  • Engineering team review
  • Technical writer review via @camunda/tech-writers unless working with an embedded writer.

[github-actions]

👋 🤖 🤔 Hello, @tasso94! 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-coverage.md
• docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/history.md
• docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/identity.md
• docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/index.md
• docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/install.md
• docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/limitations.md
• docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/runtime.md
• docs/guides/migrating-from-camunda-7/migration-tooling/index.md
• docs/guides/migrating-from-camunda-7/migration-tooling/version-compatibility.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.

[Copilot]

Pull request overview

Updates the Data Migrator documentation for the upcoming 8.9 docs set, focusing on clearer navigation and more actionable usage guidance for runtime/history/identity migration.

Changes:

• Reorganize History docs by adding a dedicated “History migration coverage” page and nesting it under a new History sidebar category.
• Improve quick start + usage examples with OS-specific command tabs and expanded configuration snippets.
• Update migration tooling metadata/wording and version compatibility to include the 0.3.x line.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
sidebars.js	Nests History under Data Migrator and adds the new coverage page to navigation.
docs/guides/migrating-from-camunda-7/migration-tooling/version-compatibility.md	Adds 0.3.x compatibility row for Camunda 8.9.
docs/guides/migrating-from-camunda-7/migration-tooling/index.md	Updates Data Migrator description to reflect runtime + history migration.
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/install.md	Expands quick start with mode overview, config additions, and OS tabs for commands.
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/runtime.md	Renames page title/label and adds OS-specific usage tabs.
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/history.md	Renames page title/label, clarifies behavior, and adds OS-specific usage tabs + tenancy notes.
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/identity.md	Renames page title/label and adds OS-specific usage tabs.
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/limitations.md	Moves/condenses history-coverage details and adds a link to the new coverage page.
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/index.md	Updates mode descriptions/table contents to match new docs structure.
docs/guides/migrating-from-camunda-7/migration-tooling/data-migrator/history-coverage.md	New page providing detailed history migration entity/property coverage tables.

---

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

[giorgionaps]

Was there a specific reason for deleting "migration" from titles here and for other docs? I feel like it was more descriptive before

[tasso94]

The whole tooling is about migration, and mentioning this word a 100 times makes it IMO not better readable but pretty redundant.

[giorgionaps]

Great updates! I've left a couple comments/suggestions. Will be waiting for a re-review 👌