quick-start phase 1

Signed-off-by: Alexander Wert <alexander.wert@elastic.co>

Author: AlexanderWert

dev-docs/README.md

@@ -16,6 +16,8 @@ The docs are currently split into three navigation sections:
 - EDOT Collector (`_edot-collector` dir)
 - EDOT SDKs (`_edot-sdks` dir)
 
+(The underscore prefix for navigation sections is a requirement.)
+
 Each markdown file results in a separate page.
 
 Docs pages can be structured hierarchically by using the `parent`, `grand_parent` and `nav_order` properties in the front matter sections in the markdown files:
@@ -53,6 +55,13 @@ You can use relative links when linking other pages within the docs. Howewver, p
 [My Link Text](./relativ/path/to/other_page.md)
 ```
 
+> [!WARNING]  
+> When linking cross navigation sections (e.g. from EDOT Collector pages to EDOT SDKs pages) make sure to **remove** the underscore `_` prefix of the section!
+>
+> Correct link: `[Link Text](../edot-sdks/java)`
+>
+> Incorrect link: `[Link Text](../_edot-sdks/java)`
+
 ### Adding Callouts
 
 In this theme we have defined two types of callouts: `NOTE` and `WARNING`.
@@ -72,6 +81,23 @@ For multi-paragraph callouts use the block syntax:
 > My second warning paragraph.
 ```
 
+### Using Artifact versions
+
+Jekyll allows to do variable replacement in markdown files. We use that feature to specify artifact versions (for download links, etc.) in the docs.
+The variables are defined in the `dcos/_config.yml` file. Use the corresponding variable (in the form of `{{ site.edot_versions.collector }}`, etc.) in markdown instead of the concrete version numbers
+
+**Correct**:
+
+```markdown 
+My markdown [link](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-darwin-arm64.tar.gz)
+```
+
+**Incorrect**:
+
+```markdown 
+My markdown [link](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.17.1-darwin-arm64.tar.gz)
+```
+
 ## Building and previewing the docs site locally
 
 ### Prerequisites 

docs/_config.yml

@@ -60,24 +60,13 @@ just_the_docs:
       nav_fold: true
   nav_sort: case_insensitive
 
-
-
-# Exclude from processing.
-# The following items will not be processed, by default.
-# Any item listed under the `exclude:` key here will be automatically added to
-# the internal "default list".
-#
-# Excluded items can be processed by explicitly listing the directories or
-# their entries' file path in the `include:` list.
-#
-# exclude:
-#   - .sass-cache/
-#   - .jekyll-cache/
-#   - gemfiles/
-#   - Gemfile
-#   - Gemfile.lock
-#   - node_modules/
-#   - vendor/bundle/
-#   - vendor/cache/
-#   - vendor/gems/
-#   - vendor/ruby/
+# EDOT versions
+edot_versions:
+  collector: 8.17.2
+  android:
+  dotnet:
+  ios:
+  java:
+  nodejs:
+  php:
+  python:

docs/_edot-collector/download.md

@@ -4,6 +4,25 @@ layout: default
 nav_order: 2
 ---
 
-# Download 
+# Download the EDOT Collector Binaries
 
-TODO
+EDOT is embedded in the Elastic Agent package, it is a separate binary that invokes only OpenTelemetry collector components.
+Below are the direct download links for **EDOT Collector version {{ site.edot_versions.collector }}** for different operating systems and architectures.
+
+| Platform      | Architecture | Download Link |
+|--------------|--------------|---------------|
+| Windows      | x86_64       | [Download](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-windows-x86_64.zip) |
+| Windows      | ARM64        | [Download](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-windows-arm64.zip) |
+| macOS        | x86_64       | [Download](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-darwin-x86_64.tar.gz) |
+| macOS        | ARM64        | [Download](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-darwin-arm64.tar.gz) |
+| Linux        | x86_64       | [Download](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-linux-x86_64.tar.gz) |
+| Linux        | ARM64        | [Download](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-linux-arm64.tar.gz) |
+| Linux (DEB)  | x86_64       | [Download](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-amd64.deb) |
+| Linux (RPM)  | x86_64       | [Download](https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{ site.edot_versions.collector }}-x86_64.rpm) |
+
+Once downloaded you can get EDOT Collector running with the below command.
+```
+sudo ./otelcol --config otel.yml
+```
+
+For use case specific configuration follow the [Quickstart guide](../quickstart) or visit the [EDOT Collector Configuration](./edot-collector-config) page for more details.

docs/_edot-collector/index.md

@@ -20,86 +20,9 @@ For full details on each option visit [this page](_edot-collector/edot-collector
 
 ## 🧩 EDOT Collector components
 
-The Elastic Distribution of OpenTelemetry (EDOT) Collector is built on OpenTelemetry’s modular architecture, integrating a carefully curated selection of Receivers, Processors, Exporters, and Extensions to ensure stability, scalability, and seamless observability. The table below categorizes these components into Core and Extended groups, highlighting the supported and production-tested components included in EDOT.
+The Elastic Distribution of OpenTelemetry (EDOT) Collector is built on OpenTelemetry’s modular architecture, integrating a carefully curated selection of Receivers, Processors, Exporters, and Extensions to ensure stability, scalability, and seamless observability. 
 
-<table style="border-collapse: collapse; width: 100%;">
-    <tr>
-        <th style="text-align: left;">Category</th>
-        <th style="text-align: left;">Component Type</th>
-        <th style="text-align: left;">Component Name</th>
-    </tr>
-    <!-- Core Components -->
-    <tr>
-        <td rowspan="14"><strong>Core</strong></td>
-        <td rowspan="2"><strong>Exporter</strong></td>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/elasticsearchexporter">elasticsearch</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector/tree/main/exporter/otlpexporter">otlp</a></td>
-    </tr>
-    <tr>
-        <td rowspan="6"><strong>Processor</strong></td>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/attributesprocessor">attributes</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector/tree/main/processor/batchprocessor">batch</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/elasticinframetricsprocessor">elasticinframetrics</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/k8sattributesprocessor">k8sattributes</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector/tree/main/processor/resourceprocessor">resource</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/resourcedetectionprocessor">resourcedetection</a></td>
-    </tr>
-    <tr>
-        <td rowspan="6"><strong>Receiver</strong></td>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/filelogreceiver">filelog</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/hostmetricsreceiver">hostmetrics</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/k8sclusterreceiver">k8s_cluster</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/k8sobjectsreceiver">k8sobjects</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/kubeletstatsreceiver">kubeletstats</a></td>
-    </tr>
-    <tr>
-        <td><a href="https://github.com/open-telemetry/opentelemetry-collector/tree/main/receiver/otlpreceiver">otlp</a></td>
-    </tr>
-    <!-- Extended Components -->
-    <tr>
-        <td rowspan="4"><strong>Extended</strong></td>
-        <td><strong>Exporter</strong></td>
-        <td><a href="https://github.com/elastic/elastic-agent/tree/main/internal/pkg/otel#exporters">Full List</a></td>
-    </tr>
-    <tr>
-        <td><strong>Receiver</strong></td>
-        <td><a href="https://github.com/elastic/elastic-agent/tree/main/internal/pkg/otel#receivers">Full List</a></td>
-    </tr>
-    <tr>
-        <td><strong>Processor</strong></td>
-        <td><a href="https://github.com/elastic/elastic-agent/tree/main/internal/pkg/otel#processors">Full List</a></td>
-    </tr>
-    <tr>
-        <td><strong>Connector</strong></td>
-        <td><a href="https://github.com/elastic/elastic-agent/tree/main/internal/pkg/otel#connectors">Full List</a></td>
-    </tr>
-</table>
-
-### Core Components
-The Core category includes production-grade, tested, and supported components selected for their stability and key observability use cases. These components ensure efficient telemetry collection, processing, and export for production environments. Each links to its respective OpenTelemetry Contrib repository for detailed functionality and configuration.
-
-### Extended Components
-The Extended category offers additional Exporters, Processors, Receivers, and Connectors for specialized observability needs. While included by default in EDOT, these components are not covered under our SLAs.
+Visit [this page](https://github.com/elastic/elastic-agent/tree/main/internal/pkg/otel#components) for the full list of components
 
 ### Request a component to be added
 To request a component to be added to EDOT Collector, please submit a [github issue](https://github.com/elastic/opentelemetry/issues/new/choose).

docs/_edot-sdks/android/android.md docs/_edot-sdks/android/index.md

@@ -5,6 +5,6 @@ nav_order: 3
 parent: Elastic Cloud Hosted
 ---
 
-# Quick Start - Docker - Hosted
+# Quickstart - Docker - Hosted
 
 TODO

docs/_edot-sdks/android/setup/setup.md docs/_edot-sdks/android/setup/index.md

@@ -5,6 +5,6 @@ nav_order: 2
 parent: Elastic Cloud Hosted
 ---
 
-# Quick Start - Hosts & VMs - Hosted
+# Quickstart - Hosts & VMs - Hosted
 
 TODO

docs/_edot-sdks/dotnet/dotnet.md docs/_edot-sdks/dotnet/index.md

@@ -2,7 +2,7 @@
 title: Elastic Cloud Hosted
 layout: default
 nav_order: 3
-parent: Quick Start
+parent: Quickstart
 ---
 
-# Quick Start on Elastic Cloud Hosted
+# Quickstart on Elastic Cloud Hosted

docs/_edot-sdks/dotnet/setup/setup.md docs/_edot-sdks/dotnet/setup/index.md

@@ -5,6 +5,6 @@ nav_order: 1
 parent: Elastic Cloud Hosted
 ---
 
-# Quick Start - Kubernetes - Hosted
+# Quickstart - Kubernetes - Hosted
 
 TODO

docs/_edot-sdks/ios/ios.md docs/_edot-sdks/ios/index.md

@@ -1,5 +1,5 @@
 ---
-title: Quick Start
+title: Quickstart
 layout: default
 nav_order: 2
 ---
@@ -10,25 +10,25 @@ 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.*
 
-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`):
+Choose the Quickstart 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 🗄️ 🖥 ] |
+|                                    | ☸️ **Kubernetes**            | 🐳 **Docker**                 | 🖥 **Hosts / VMs**           |
+|------------------------------------|:---------------------------:|:-----------------------------:|:---------------------------:|
+| 🆂 **Self-managed Elastic Stack**  | [Quickstart 🆂 ☸️]{: .btn }   | [Quickstart 🆂 🐳 ]{: .btn }  | [Quickstart 🆂 🖥 ]{: .btn } |
+| ☁️ **Elastic Cloud Serverless**     | [Quickstart ☁️ ☸️]{: .btn }   | [Quickstart ☁️ 🐳 ]{: .btn }   | [Quickstart ☁️ 🖥 ]{: .btn }  |
+| 🗄️ **Elastic Cloud Hosted**        | [Quickstart 🗄️ ☸️]{: .btn }   | [Quickstart 🗄️ 🐳 ]{: .btn }  | [Quickstart 🗄️ 🖥 ]{: .btn } |
 
 ## Troubleshooting
 - [EDOT Collector Troubleshooting](_edot-collector/edot-collector-troubleshoot.md)
 - [Auto-instrumentation Troubleshooting](_kubernetes/operator/troubleshoot-auto-instrumentation.md).
 
 
-[Quick Start 🆂 ☸️]: ./self-managed/k8s
-[Quick Start ☁️ ☸️]: ./serverless/k8s
-[Quick Start 🗄️ ☸️]: ./ech/k8s
-[Quick Start 🆂 🐳 ]: ./self-managed/docker
-[Quick Start ☁️ 🐳 ]: ./serverless/docker
-[Quick Start 🗄️ 🐳 ]: ./ech/docker
-[Quick Start 🆂 🖥 ]: ./self-managed/hosts_vms
-[Quick Start ☁️ 🖥 ]: ./serverless/hosts_vms
-[Quick Start 🗄️ 🖥 ]: ./ech/hosts_vms
+[Quickstart 🆂 ☸️]: ./self-managed/k8s
+[Quickstart ☁️ ☸️]: ./serverless/k8s
+[Quickstart 🗄️ ☸️]: ./ech/k8s
+[Quickstart 🆂 🐳 ]: ./self-managed/docker
+[Quickstart ☁️ 🐳 ]: ./serverless/docker
+[Quickstart 🗄️ 🐳 ]: ./ech/docker
+[Quickstart 🆂 🖥 ]: ./self-managed/hosts_vms
+[Quickstart ☁️ 🖥 ]: ./serverless/hosts_vms
+[Quickstart 🗄️ 🖥 ]: ./ech/hosts_vms

docs/_edot-sdks/ios/setup/setup.md docs/_edot-sdks/ios/setup/index.md

@@ -1,8 +1,14 @@
 ---
-title: Hosts & VMs
+title: Docker
 layout: default
 nav_order: 3
 parent: Self-managed
 ---
 
-# Quick Start - Docker - Self-managed
+# Quickstart
+
+🐳 Docker
+{: .label .label-blue }
+
+🆂 Self-managed Elastic Stack
+{: .label .label-yellow }