Restructure OpenTelemetry Documentation

[brett0000FF]

What does this PR do? What is the motivation?

Restructure OpenTelemetry documentation into a more logical structure. This will make it easier for readers to find what they are looking for, and it will improve maintenance of these docs as we continue to add more content.

Jira: https://datadoghq.atlassian.net/browse/DOCS-6974
Brainstorming: FigJam.

Preview: https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/

• Added Terms and Concepts page.
• Split Set up Collector and Exporter into Deployment, Configuration, Management, and Integrations pages.
• Added Schema and Semantics section that organizes related content.
• Added Interoperability with Datadog section that organizes related content.
• New Troubleshooting page.
• Updated Guides to include resources as well (like the Registry).

Merge instructions

• Please merge after reviewing

Additional notes

[github-actions]

Preview links (active after the build_preview check completes)

New or renamed files

• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/collector_exporter/configuration
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/collector_exporter/deployment
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/interoperability/
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/otel_terms
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/schema_semantics/
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/troubleshooting

Removed or renamed files (these should redirect)

• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/otel_tracing

Renamed files

• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/collector_exporter/otel_collector_datadog_exporter
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/ingestion_sampling_with_opentelemetry
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/docker_metrics
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/host_metrics
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/log_collection
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/runtime_metrics/
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/runtime_metrics/dotnet
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/runtime_metrics/go
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/runtime_metrics/java
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/integrations/trace_metrics
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/interoperability/otel_api_tracing_interoperability
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/interoperability/otlp_ingest_in_the_agent
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/schema_semantics/host_metadata
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/schema_semantics/metrics_mapping
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/schema_semantics/semantic_mapping

Modified Files

• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/collector_exporter/
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/collector_exporter/otlp_receiver
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/guide/
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/guide/otlp_delta_temporality
• https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/tracing/trace_collection/custom_instrumentation/otel_instrumentation/

[julianocosta89]

Hello @brett0000FF 👋🏽

I think this re-structure is a good start, IMO we are missing some pages in the docs, but we can definitely work on that after this initial PR.

Just one thing that I'd suggest, not sure if it is doable:

In the Data Collection section we go to the page, and we have 2 links to chose from.
Would it be possible to make this page as the final one?
I mean, the user clicks on the Data Collection and it is presented with the differences between the 2 options, focusing on the advantages of each one of them and then 2 tabs explaining each case:

• OTel Collector
• Datadog Agent

WDYT?

[brett0000FF]

In the Data Collection section we go to the page, and we have 2 links to chose from. Would it be possible to make this page as the final one? I mean, the user clicks on the Data Collection and it is presented with the differences between the 2 options, focusing on the advantages of each one of them and then 2 tabs explaining each case:

• OTel Collector
• Datadog Agent

WDYT?

@julianocosta89 - Yeah, I definitely agree with that. I planned to expand on that content to explain the differences, rather than just a simple link. I met with Irene today about this structure, and she's going to suggest some other high-level structure changes. Once we get that sorted out, it'll become more clear where we need to fill in content gaps. Thanks for taking a look!

[julianocosta89]

@brett0000FF https://docs-staging.datadoghq.com/brett0000FF/otel-reorg/opentelemetry/interoperability/otlp_delta_temporality/ seems to be failing.

Also, I've mentioned you on the TOC Doc, where I said that we should move Datadog Exporter and OTLP Receiver to Configuration and leave the others in Integrations, as those 2 are not integrations.

[julianocosta89]

1 minor suggestion, but LGTM 🚀

[buraizu]

Looks good, approving with some minor feedback!