Reorganize OTel Documentation

[brett0000FF]

What does this PR do? What is the motivation?

• More Action-Oriented Top-Level Categories: The new structure organizes content around key user tasks and goals rather than technical concepts. For example, "Send Data to Datadog" and "Instrument Your Applications" replace more abstract categories like "Interoperability with Datadog."
• Clearer Flow: The content follows a more logical flow, with key setup paths more clearly defined.
• Better Separation of Core vs Advanced Topics: The structure more clearly separates fundamental setup tasks from advanced features and customizations, helping users focus on essential setup steps before diving into advanced capabilities.
• More Intuitive Grouping: Related topics are grouped together more logically. For example, all correlation-related content (Logs-Traces, RUM-Traces) is now under "Correlate Data."

FIgJam: https://www.figma.com/board/wW2cAzPkZ5dZ8QcaS8stF1/OpenTelemetry-Docs-Restructure?node-id=2002-104&t=AzCjZzN3F6S30Y6w-1

TODO

• Include page shortcode for content on /tracing/other_telemetry/connect_logs_and_traces/opentelemetry/
• Landing page content draft
• Overview page content drafts
• Add migration guides section
• Add new graphics (maybe in a follow up PR). Brand Design is working on new graphics (ETA 2/21).
• Finalize redirects

Merge instructions

Merge readiness:

• Ready for merge

Merge queue is enabled in this repo. To have it automatically merged after it receives the required reviews, create the PR (from a branch that follows the <yourname>/description naming convention) and then add the following PR comment:

/merge

Additional notes

[github-actions]

Preview links (active after the build_preview check completes)

New or renamed files

• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/config/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/correlate/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/correlate/logs_and_traces
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/guide/migrate/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/api_support/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/api_support/dotnet
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/api_support/go
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/api_support/java
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/api_support/nodejs
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/api_support/php
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/api_support/python
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/api_support/ruby
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/otel_sdks
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/mapping/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/reference/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/reference/trace_ids
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/setup/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/setup/intake_endpoint/

Removed or renamed files (these should redirect)

• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/collector_exporter/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/collector_exporter/otel_collector_datadog_exporter
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/interoperability/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/interoperability/api_support
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/interoperability/otel_api_tracing_interoperability
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/otel_logs
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/schema_semantics/

Renamed files

• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/config/collector_batch_memory
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/config/environment_variable_support
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/config/hostname_tagging
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/config/log_collection
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/config/otlp_receiver
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/correlate/rum_and_traces
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/guide/migrate/collector_0_95_0
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/guide/migrate/migrate_operation_names
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/ingestion_sampling
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/instrument/instrumentation_libraries
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/mapping/host_metadata
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/mapping/hostname
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/mapping/metrics_mapping
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/mapping/semantic_mapping
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/mapping/service_entry_spans
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/reference/concepts
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/reference/otel_metrics
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/reference/otlp_metric_types
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/reference/trace_context_propagation
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/setup/collector_exporter/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/setup/collector_exporter/deploy
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/setup/intake_endpoint/otlp_logs
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/setup/intake_endpoint/otlp_metrics
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/setup/intake_endpoint/otlp_traces
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/setup/otlp_ingest_in_the_agent

Modified Files

• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/getting_started/opentelemetry/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/metrics/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/metrics/open_telemetry/otlp_metrics
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/metrics/summary
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/guide/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/guide/otlp_histogram_heatmaps

[domalessi]

Also, noting that these don't redirect:

• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/interoperability/
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/interoperability/trace_context_propagation
• https://docs-staging.datadoghq.com/brett.blue/reorg-otel/opentelemetry/schema_semantics/

[domalessi]

Beautiful 🤌

[brett0000FF]

Approved by Anna offline.

[brett0000FF]

/merge -p urgent

[dd-devflow]

View all feedbacks in Devflow UI.
2025-03-12 17:21:46 UTC ℹ️ Start processing command /merge -p urgent

---

2025-03-12 17:21:55 UTC ℹ️ MergeQueue: pull request added to the queue

The expected merge time in master is approximately 9m (p90).

---

2025-03-12 17:22:09 UTC ❌ MergeQueue: This merge request is not mergeable, blocked by github

PR can't be merged according to github policy