Add migration hub: consolidate migration docs into a single top-level section#5946
Add migration hub: consolidate migration docs into a single top-level section#5946alexandra5000 wants to merge 9 commits intoelastic:mainfrom
Conversation
Update relative links in moved files that relied on their old directory depth, and update outbound links in external files that still pointed to the old paths. Also fixes substitute and version syntax hints in to-edot-collector/index.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Update ~30 files that still linked to old paths for docs moved into the new migrate/ hub. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Kept hub path for Automatic Migration (/migrate/to-elastic-security/automatic-migration.md) and took upstream's new path for Automatic Import (/explore-analyze/ai-features/automatic-import.md). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
Hi - spotted this because I got pinged on elastic/docs-builder#3190 I think this section is too broadly scoped. When people think about moving from one tool to another in terms of internal elasticsearch functionality, they don't think about it as "migrating", but instead, moving between tools or features. To me, migration (as presented in https://www.elastic.co/docs/manage-data/migrate) is PURELY a "get your data from one source to another" question, e.g. migrating between non-elastic and elastic platform, or migrating between elastic instances for one reason or another. This is a key use case that needs its own space. Would suggest that these should stay where they are:
humbly suggest that moving between ingest tools should also stay out of this section, to keep the core story (which my team owns) clear. |
|
Also to note: big changes are happening in this section right now. This PR definitely can't move forward until #5244 is merged. |
2 participants
Summary
Creates a new
migrate/top-level section consolidating all migration docs currently scattered across Reference, Manage data, and Solutions.manage-dataindocset.yml— final nav placement is pending elastic/docs-builder#2927Closes https://github.com/elastic/docs-content-internal/issues/831
What moved where
reference/fleet/migrate-from-beats-to-elastic-agent.mdmigrate/beats-to-elastic-agent/migrate-from-beats.mdreference/fleet/migrate-auditbeat-to-agent.mdmigrate/beats-to-elastic-agent/migrate-from-auditbeat.mdmanage-data/migrate.mdmigrate/elasticsearch-data/index.mdmanage-data/migrate/migrate-data-between-elasticsearch-clusters-with-minimal-downtime.mdmigrate/elasticsearch-data/cluster-to-cluster.mdmanage-data/migrate/migrate-with-logstash.mdmigrate/elasticsearch-data/with-logstash.mdmanage-data/migrate/migrate-internal-indices.mdmigrate/elasticsearch-data/system-indices.mdmanage-data/migrate/migrate-from-a-self-managed-cluster-with-a-self-signed-certificate-using-remote-reindex.mdmigrate/elasticsearch-data/remote-reindex.mdmanage-data/lifecycle/index-lifecycle-management/migrate-ilm.mdmigrate/data-management/index.mdmanage-data/lifecycle/index-lifecycle-management/migrate-index-management.mdmigrate/data-management/to-ilm.mdmanage-data/lifecycle/index-lifecycle-management/migrate-index-allocation-filters-to-node-roles.mdmigrate/data-management/to-data-tiers.mdmanage-data/lifecycle/data-stream/tutorial-migrate-ilm-managed-data-stream-to-data-stream-lifecycle.mdmigrate/data-management/ilm-to-data-stream-lifecycle.mdmanage-data/lifecycle/rollup/migrating-from-rollup-to-downsampling.mdmigrate/data-management/rollup-to-downsampling.mdsolutions/security/get-started/automatic-migration.mdmigrate/to-elastic-security/automatic-migration.mdWhat stays in place (linked from hub, not moved)
deploy-manage/— ECE Podman, remote cluster auth, CCS template, Heroku (infrastructure ops)deploy-manage/upgrade/— Kibana saved object migrations (upgrade context)solutions/observability/synthetics/migrate-from-elastic-synthetics-integration.md(product-specific)reference/fleet/migrate-elastic-agent.md(operational agent task, not ingest migration)troubleshoot/migration pagesNew content added
migrate/apm-agents-to-edot/rum-js.md— Preview-state page for Elastic APM RUM JS → EDOT Browser migration; full guide pending EDOT Browser GAmigrate/to-edot-collector/from-apm-agents.md— Guide for migrating from APM Server ingestion to the EDOT Collectormigrate/to-edot-collector/from-upstream-collector.md— Full guide for migrating from an upstream OpenTelemetry Collector to EDOT CollectorNavigation and titles
All subsection nav titles follow a consistent "Migrate..." pattern. Sections are ordered by expected usage frequency:
Remaining placeholder
migrate/data-management/ecs-field-mapping.md— ECS field mapping migration (content not yet available)Known build issue
22 validation errors of the form
Can not validate docs-content://migrate/...becausemigrate/is not yet registered in docs-builder'sconfig/navigation.yml. This requires a separate docs-builder PR and will be addressed once elastic/docs-builder#2927 merges.🤖 Generated with Claude Code