quick-start phase 1

Signed-off-by: Alexander Wert <[email protected]>

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).