mkdocs.yml

site_name: Datadog Agent
site_description: The home of Datadog Agent developer documentation
site_author: Datadog
site_url: https://datadoghq.dev/datadog-agent/
repo_name: datadog/datadog-agent
repo_url: https://github.com/DataDog/datadog-agent
edit_uri: blob/main/docs/public
copyright: Copyright © Datadog, Inc. 2024-present

docs_dir: docs/public
site_dir: site
theme:
  name: material
  language: en
  font:
    text: Roboto
    code: Roboto Mono
  favicon: assets/images/favicon.ico
  logo: assets/images/logo.svg
  icon:
    repo: fontawesome/brands/github-alt
  palette:
  - media: "(prefers-color-scheme: dark)"
    scheme: slate
    primary: custom
    toggle:
      icon: material/weather-night
      name: Switch to light mode
  - media: "(prefers-color-scheme: light)"
    scheme: default
    primary: custom
    toggle:
      icon: material/weather-sunny
      name: Switch to dark mode
  features:
  - content.action.edit
  - content.code.copy
  - content.tabs.link
  - content.tooltips
  - navigation.expand
  - navigation.footer
  - navigation.indexes
  - navigation.instant
  - navigation.sections
  - navigation.tabs
  - navigation.tabs.sticky

nav:
- Home:
  - About: index.md
  - Setup:
    - Required: setup/required.md
    - Optional: setup/optional.md
    - Manual: setup/manual.md
- How-to:
  - Build:
    - Standalone agents: how-to/build/standalone.md
    - Distribution packages: how-to/build/distributions.md
  - Test:
    - Unit tests: how-to/test/unit.md
    - Static analysis: how-to/test/static-analysis.md
    - End-to-end tests: how-to/test/e2e.md
  - Go:
    - Add nested modules: how-to/go/modules.md
  - Debug agents:
    - how-to/debug-agents/index.md
    - Linux: how-to/debug-agents/linux.md
    - Windows: how-to/debug-agents/windows.md
  - Memory profiling:
    - Overview: how-to/memory-profiling/overview.md
    - Go: how-to/memory-profiling/go.md
    - Python: how-to/memory-profiling/python.md
    - C++: how-to/memory-profiling/c++.md
- Tutorials:
  - Develop:
    - Environment usage: tutorials/dev/env.md
    - Lab environments:
      - tutorials/dev/lab/index.md
      - Kind: tutorials/dev/lab/kind.md
- Guidelines:
  - Contributing: guidelines/contributing.md
  - Documentation: guidelines/docs.md
  - Languages:
    - Go: guidelines/languages/go.md
    - Rust: guidelines/languages/RUST.md
  - Testing:
    - Test categories: guidelines/testing/test-categories.md
  - Conventions:
    - Logging: guidelines/conventions/logging.md
- Components:
  - Overview: components/overview.md
  - Components:
    - Creating components: components/creating-components.md
    - Testing components: components/testing.md
    # - Creating bundles: components/creating-bundles.md
    - Using components: components/using-components.md
    # - Common patterns: components/common-patterns.md
  - Shared features from components:
    # - Integrating with other components: components/migration.md
    - Features:
      - Flare: components/shared_features/flares.md
      -  Status: components/shared_features/status.md
  #     - TODO Remote Config: components/shared_features/remote_config.md
  #     - TODO Metadata: components/shared_features/metadata.md
  #     - TODO workloadmeta: components/shared_features/workloadmeta.md
  #     - TODO more ?: TMP
  # - Fx overview: components/fx.md
  # - JMXFetch overview: components/jmxfetch.md
  # - FAQ: components/faq.md
- Agent Schema:
  - Introduction: agent-schema/index.md
  - Keyword Reference: agent-schema/keywords.md
  - Examples: agent-schema/examples.md
  - FAQ: agent-schema/faq.md
- Architecture:
  - DogStatsD:
    - Internals: architecture/dogstatsd/internals.md
- Reference:
  - Images:
    - Developer environment: reference/images/dev.md
    - Builders: reference/images/builders.md
  - Agent buildables:
    - Agent components: reference/builds/components.md

watch:
- .go-version

hooks:
- docs/public/.hooks/plugin_register.py
- docs/public/.hooks/title_from_content.py

plugins:
  # Enable for bug reports
  # info: {}
  # Built-in
  search: {}
  # Extra
  glightbox: {}
  minify:
    minify_html: true
  git-revision-date-localized:
    type: date
    strict: false
  redirects:
    redirect_maps:
      setup.md: setup/required.md

markdown_extensions:
# Built-in
- markdown.extensions.abbr:
- markdown.extensions.attr_list:
- markdown.extensions.footnotes:
- markdown.extensions.md_in_html:
- markdown.extensions.meta:
- markdown.extensions.tables:
- markdown.extensions.toc:
    permalink: true
# Extra
- pymdownx.arithmatex:
- pymdownx.betterem:
    smart_enable: all
- pymdownx.blocks.admonition:
    # https://squidfunk.github.io/mkdocs-material/reference/admonitions/#supported-types
    types:
    - abstract
    - bug
    - danger
    - example
    - failure
    - info
    - note
    - question
    - quote
    - success
    - tip
    - warning
- pymdownx.blocks.details:
    # Same as admonition types except prefixed by `details-`
    types:
    - name: details-abstract
      class: abstract
    - name: details-bug
      class: bug
    - name: details-danger
      class: danger
    - name: details-example
      class: example
    - name: details-failure
      class: failure
    - name: details-info
      class: info
    - name: details-note
      class: note
    - name: details-question
      class: question
    - name: details-quote
      class: quote
    - name: details-success
      class: success
    - name: details-tip
      class: tip
    - name: details-warning
      class: warning
- pymdownx.blocks.tab:
    alternate_style: true
    slugify: !!python/object/apply:pymdownx.slugs.slugify
      kwds:
        case: lower
- pymdownx.caret:
- pymdownx.critic:
- pymdownx.details:
- pymdownx.emoji:
    # https://github.com/twitter/twemoji
    # https://raw.githubusercontent.com/facelessuser/pymdown-extensions/master/pymdownx/twemoji_db.py
    emoji_index: !!python/name:material.extensions.emoji.twemoji
    emoji_generator: !!python/name:material.extensions.emoji.to_svg
- pymdownx.highlight:
    anchor_linenums: true
    line_spans: __span
    linenums_style: pymdownx-inline
    pygments_lang_class: true
- pymdownx.inlinehilite:
- pymdownx.keys:
- pymdownx.magiclink:
    repo_url_shortener: true
    repo_url_shorthand: true
    social_url_shortener: true
    social_url_shorthand: true
    normalize_issue_symbols: true
    provider: github
    user: DataDog
    repo: datadog-agent
- pymdownx.mark:
- pymdownx.progressbar:
- pymdownx.saneheaders:
- pymdownx.smartsymbols:
- pymdownx.snippets:
    check_paths: true
    base_path:
    - docs/public/.snippets
    auto_append:
    - links.txt
    - abbrs.txt
- pymdownx.superfences:
- pymdownx.tasklist:
    custom_checkbox: true
- pymdownx.tilde:

extra:
  social:
  - icon: fontawesome/solid/blog
    link: https://www.datadoghq.com/blog/engineering/
  - icon: fontawesome/brands/github-alt
    link: https://github.com/DataDog
  - icon: fontawesome/brands/twitter
    link: https://twitter.com/datadoghq
  - icon: fontawesome/brands/instagram
    link: https://www.instagram.com/datadoghq
extra_css:
- assets/css/custom.css
- https://cdn.jsdelivr.net/npm/firacode@6.2.0/distr/fira_code.css