refined structure

AlexanderWert · AlexanderWert · commit c5b05460dd59 · 2025-03-06T17:02:53.000+01:00
Signed-off-by: Alexander Wert &lt;alexander.wert@elastic.co&gt;
diff --git a/docs/_edot-sdks/java/setup/k8s.md b/docs/_edot-sdks/java/setup/k8s.md
@@ -1,8 +1,9 @@
 ---
-title: Java Applications
+title: EDOT Java on Kubernetes
 layout: default
 nav_order: 1
-parent: Instrumenting Applications
+parent: Setup
+grand_parent: EDOT Java
 ---
 
 # Instrumenting Java applications with EDOT SDKs on Kubernetes
diff --git a/docs/_edot-sdks/java/setup/setup.md b/docs/_edot-sdks/java/setup/setup.md
diff --git a/docs/_edot-sdks/nodejs/setup/k8s.md b/docs/_edot-sdks/nodejs/setup/k8s.md
@@ -1,8 +1,9 @@
 ---
-title: Node.js Applications
+title: EDOT Node.js on Kubernetes
 layout: default
-nav_order: 2
-parent: Instrumenting Applications
+nav_order: 1
+parent: Setup
+grand_parent: EDOT Node.js
 ---
 
 # Instrumenting Node.js applications with EDOT SDKs on Kubernetes
diff --git a/docs/_edot-sdks/nodejs/setup/setup.md b/docs/_edot-sdks/nodejs/setup/setup.md
@@ -0,0 +1,13 @@
+---
+title: Setup
+layout: default
+nav_order: 1
+parent: EDOT Node.js
+---
+
+# Setting up EDOT Node.js
+
+TODO:
+- where to download
+- explicit description of basic setup here (even if it overlaps with upstream docs)
+- link to upstream docs for more advanced setup use cases
diff --git a/docs/_edot-sdks/python/setup/k8s.md b/docs/_edot-sdks/python/setup/k8s.md
@@ -1,8 +1,9 @@
 ---
-title: Python Applications
+title: EDOT Python on Kubernetes
 layout: default
-nav_order: 3
-parent: Instrumenting Applications
+nav_order: 1
+parent: Setup
+grand_parent: EDOT Python
 ---
 
 # Instrumenting Python applications with EDOT SDKs on Kubernetes
diff --git a/docs/_edot-sdks/python/setup/setup.md b/docs/_edot-sdks/python/setup/setup.md
@@ -0,0 +1,13 @@
+---
+title: Setup
+layout: default
+nav_order: 1
+parent: EDOT Python
+---
+
+# Setting up EDOT Python
+
+TODO:
+- where to download
+- explicit description of basic setup here (even if it overlaps with upstream docs)
+- link to upstream docs for more advanced setup use cases
diff --git a/docs/_kubernetes/operator/troubleshoot-auto-instrumentation.md b/docs/_kubernetes/operator/troubleshoot-auto-instrumentation.md
diff --git a/docs/deployment-options/ech.md b/docs/deployment-options/ech.md
diff --git a/docs/deployment-options/index.md b/docs/deployment-options/index.md
diff --git a/docs/deployment-options/self-managed.md b/docs/deployment-options/self-managed.md
diff --git a/docs/deployment-options/serverless.md b/docs/deployment-options/serverless.md
diff --git a/docs/quickstart/ech/docker.md b/docs/quickstart/ech/docker.md
@@ -0,0 +1,10 @@
+---
+title: Hosts & VMs
+layout: default
+nav_order: 3
+parent: Elastic Cloud Hosted
+---
+
+# Quick Start - Docker - Hosted
+
+TODO
diff --git a/docs/quickstart/ech/hosts_vms.md b/docs/quickstart/ech/hosts_vms.md
@@ -0,0 +1,10 @@
+---
+title: Hosts & VMs
+layout: default
+nav_order: 2
+parent: Elastic Cloud Hosted
+---
+
+# Quick Start - Hosts & VMs - Hosted
+
+TODO
diff --git a/docs/quickstart/ech/index.md b/docs/quickstart/ech/index.md
@@ -5,4 +5,4 @@ nav_order: 3
 parent: Quick Start
 ---
 
-# EDOT Quick Start on Elastic Cloud Hosted
+# Quick Start on Elastic Cloud Hosted
diff --git a/docs/quickstart/ech/k8s.md b/docs/quickstart/ech/k8s.md
@@ -0,0 +1,10 @@
+---
+title: Kubernetes
+layout: default
+nav_order: 1
+parent: Elastic Cloud Hosted
+---
+
+# Quick Start - Kubernetes - Hosted
+
+TODO
diff --git a/docs/quickstart/index.md b/docs/quickstart/index.md
@@ -10,24 +10,13 @@ This guide helps you set up Elastic Distributions for OpenTelemetry (EDOT) to mo
 
 > 🏁 *By the end of this guide, you’ll have a fully operational EDOT-powered monitoring pipeline sending data to Elastic Observability.*
 
-|                               | **Kubernetes**            | **Docker**                 | **Hosts & VMs**           |
-|-------------------------------|:-------------------------:|:--------------------------:|:-------------------------:|
-| **Self-managed**              | [Quick Start 🆂 ☸️]       | [Quick Start 🆂 🐳 ]      | [Quick Start 🆂 🖥 ] |
-| **Elastic Cloud Serverless**  | [Quick Start ☁️ ☸️]        | [Quick Start ☁️ 🐳 ]    | [Quick Start ☁️ 🖥 ] |
-| **Elastic Cloud Hosted**      |  [Quick Start 🗄️ ☸️]     |   [Quick Start 🗄️ 🐳 ]  | [Quick Start 🗄️ 🖥 ] |
-
-
-## 📖 Guide content
-
-* [Kubernetes](./kubernetes)
-
-* Infrastructure & Application Monitoring](#%EF%B8%8F-kubernetes---infrastructure--application--monitoring)
-
-* Hosts Monitoring and Log collection
-  * [Linux](#linux)
-  * [Mac](#macos)
-  * [Windows](#windows)
+Choose the Quick Start guide based on the environment of your target system (`Kubernetes`, `Docker` or plain `Hosts / VMs`) and your Elastic deployment model (`Self-managed`, `Elastic Cloud Serverless`, `Elastic Cloud Hosted`):
 
+|                                 | ☸️ **Kubernetes**            | 🐳 **Docker**                 | 🖥 **Hosts / VMs**           |
+|---------------------------------|:-------------------------:|:--------------------------:|:-------------------------:|
+| 🆂 **Self-managed Elastic Stack**  | [Quick Start 🆂 ☸️]        | [Quick Start 🆂 🐳 ]        | [Quick Start 🆂 🖥 ] |
+| ☁️ **Elastic Cloud Serverless**    |  [Quick Start ☁️ ☸️]        | [Quick Start ☁️ 🐳 ]        | [Quick Start ☁️ 🖥 ] |
+| 🗄️ **Elastic Cloud Hosted**        |  [Quick Start 🗄️ ☸️]       |   [Quick Start 🗄️ 🐳 ]      | [Quick Start 🗄️ 🖥 ] |
 
 ## Troubleshooting
 - [EDOT Collector Troubleshooting](_edot-collector/edot-collector-troubleshoot.md)
diff --git a/docs/quickstart/self-managed/docker.md b/docs/quickstart/self-managed/docker.md
@@ -0,0 +1,8 @@
+---
+title: Hosts & VMs
+layout: default
+nav_order: 3
+parent: Self-managed
+---
+
+# Quick Start - Docker - Self-managed
diff --git a/docs/quickstart/self-managed/hosts_vms.md b/docs/quickstart/self-managed/hosts_vms.md
@@ -5,18 +5,21 @@ nav_order: 2
 parent: Self-managed
 ---
 
-# Hosts & VMs - Quick Start
+# Quick Start - Hosts & VMs - Self-managed
+
 These instructions guide you through setting up the EDOT Collector to collect host metrics, logs and application traces using an OpenTelemetry configuration. You’ll download the appropriate package for your system, configure authentication, and run the collector. Optional steps allow you to customize log collection paths and set up application monitoring.
-![EDOT-host-metrics-logs](../images/edot-host-metrics-logs.png)
+![EDOT-host-metrics-logs](../../images/edot-host-metrics-logs.png)
 
 ## Run EDOT Collector for Host Metrics and Log collection
+
 These instructions will download EDOT collector including an OpenTelemetry collector configuration that will:
 
 * Collect metrics from your host 
 * Collect logs from a set of locations in your host
 Run the below commands to download the EDOT Collector package relevant to your system's architecture. 
 
 ### Linux
+
 Download EDOT Collector
 
 ```bash
diff --git a/docs/quickstart/self-managed/index.md b/docs/quickstart/self-managed/index.md
@@ -5,4 +5,4 @@ nav_order: 1
 parent: Quick Start
 ---
 
-# EDOT Quick Start with a Self-managed Elastic Stack
+# Quick Start with a Self-managed Elastic Stack
diff --git a/docs/quickstart/self-managed/k8s.md b/docs/quickstart/self-managed/k8s.md
@@ -5,7 +5,7 @@ nav_order: 1
 parent: Self-managed
 ---
 
-# ☸️ Kubernetes - Quick Start
+# Quick Start - Kubernetes - Self-managed
 
 The quick start for Kubernetes covers collection of OpenTelemetry data for infrastructure monitoring, logs collection and application  monitoring. These instructions will install an OpenTelemetry Operator preconfigured to automate orchestration of EDOT as below:
  
@@ -14,7 +14,7 @@ The quick start for Kubernetes covers collection of OpenTelemetry data for infra
 * **EDOT Collector Gateway:** perform APM pre-processing (when applicable). Route all telemetry to Elastic,  
 * **EDOT SDKs**: Annotated applications will be auto-instrumented with EDOT SDKs
   
-![K8s-architecture](../images/EDOT-K8s-architecture.png)
+![K8s-architecture](../../images/EDOT-K8s-architecture.png)
 
 ## Kubernetes Infrastructure Metrics and Log Collection
 
diff --git a/docs/quickstart/serverless/docker.md b/docs/quickstart/serverless/docker.md
@@ -0,0 +1,10 @@
+---
+title: Hosts & VMs
+layout: default
+nav_order: 3
+parent: Elastic Cloud Serverless
+---
+
+# Quick Start - Docker - Serverless
+
+TODO
diff --git a/docs/quickstart/serverless/hosts_vms.md b/docs/quickstart/serverless/hosts_vms.md
@@ -0,0 +1,10 @@
+---
+title: Hosts & VMs
+layout: default
+nav_order: 2
+parent: Elastic Cloud Serverless
+---
+
+# Quick Start - Hosts & VMs - Serverless
+
+TODO
diff --git a/docs/quickstart/serverless/index.md b/docs/quickstart/serverless/index.md
@@ -5,4 +5,4 @@ nav_order: 2
 parent: Quick Start
 ---
 
-# EDOT Quick Start on Elastic Cloud Serverless
+# Quick Start on Elastic Cloud Serverless
diff --git a/docs/quickstart/serverless/k8s.md b/docs/quickstart/serverless/k8s.md
@@ -0,0 +1,10 @@
+---
+title: Kubernetes
+layout: default
+nav_order: 1
+parent: Elastic Cloud Serverless
+---
+
+# Quick Start - Kubernetes - Serverless
+
+TODO
diff --git a/docs/use-cases/host-metrics.md b/docs/use-cases/host-metrics.md
@@ -0,0 +1,8 @@
+---
+title: Collecting Host Metrics
+layout: default
+nav_order: 2
+parent: Use Cases
+---
+
+# Collecting Host Metrics with EDOT
diff --git a/docs/use-cases/index.md b/docs/use-cases/index.md
@@ -0,0 +1,7 @@
+---
+title: Use Cases
+layout: default
+nav_order: 3
+---
+
+# Use Cases
diff --git a/docs/use-cases/instrumenting-applications.md b/docs/use-cases/instrumenting-applications.md
diff --git a/docs/use-cases/kubernetes.md b/docs/use-cases/kubernetes.md
diff --git a/docs/use-cases/logs.md b/docs/use-cases/logs.md
diff --git a/docs/use-cases/traces.md b/docs/use-cases/traces.md
