mkdocs.yml

site_name: Telemetry Forge Product Documentation
site_url: https://telemetryforge.io
nav:
  - Home: index.md
  - Telemetry Forge Agent:
    - agent/index.md
    - Getting Started: agent/getting-started.md
    - Features:
      - Overview: agent/features/index.md
      - Environment Variables: agent/features/environment-variables.md
      - Record Deduplication: agent/features/record-deduplication.md
      - Log Sampling: agent/features/log-sampling.md
      - Git Configuration Auto-Reload: agent/features/git-config-auto-reload.md
      - Hardening and Optimisation: agent/build-optimisations.md
      - AI filtering and routing: agent/features/llm-tagging.md
    - Security:
      - Overview: agent/security.md
      - CVE Information: agent/security/cves.md
      - Current Triaged Vulnerabilities: agent/security/triaged.md
    - Supported Platforms: agent/supported-platforms.md
    - Version Mapping: agent/version-mapping.md
  - Fully Managed Logs:
    - fully-managed-logs/index.md
  - Fleet Manager:
    - fleet-manager/index.md
    - Core Concepts: fleet-manager/core-concepts.md
    - Common Use Cases: fleet-manager/use-cases.md
    - Operations Guide: fleet-manager/operations-guide.md
    - Comparisons:
      - Overview: fleet-manager/comparisons/index.md
      - Fleet Compatibility: fleet-manager/comparisons/fleet-compatibility.md
      - Deployment and Lock-In: fleet-manager/comparisons/deployment-and-lock-in.md

# These files are generated and used elsewhere so just ignore them in the navigation to prevent warnings
not_in_nav: |
  /agent/security/**/grype-*.md
  /agent/security/triaged/README.md

plugins:
  - privacy
  - offline
  - search
  - social
  - meta
  - redirects:
      redirect_maps:
        "security.md": "agent/security.md"
        "build-optimisations.md": "agent/build-optimisations.md"
        "supported-platforms.md": "agent/supported-platforms.md"
        "version-mapping.md": "agent/version-mapping.md"
        "features/git-config-auto-reload.md": "agent/features/git-config-auto-reload.md"
        "features/log-sampling.md": "agent/features/log-sampling.md"
        "features/record-deduplication.md": "agent/features/record-deduplication.md"
        "security/cves.md": "agent/security/cves.md"
        "security/triaged.md": "agent/security/triaged.md"
markdown_extensions:
  - pymdownx.details
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - attr_list
  - md_in_html
  - toc

theme:
  name: material
  logo: assets/favicon/logo-mark-512.png
  favicon: assets/favicon/favicon-32x32.png
  highlightjs: true
  copyright: Telemetry Forge 2026
  custom_dir: overrides

  palette:
    # Dark Mode
    - scheme: slate
      toggle:
        icon: material/weather-sunny
        name: Dark mode
      primary: teal
      accent: teal

    # Light Mode
    - scheme: default
      toggle:
        icon: material/weather-night
        name: Light mode
      primary: teal
      accent: teal
  features:
    - header.autohide
    - announce.dismiss
    - navigation.top
    - navigation.footer
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.path
    - navigation.indexes

extra_css:
  - assets/stylesheets/brand.css

extra:
  homepage: https://telemetryforge.io
  # Disable made by mkdocs
  generator: false
  consent:
    title: Cookie consent
    description: >-
      We use cookies to recognize your repeated visits and preferences, as well
      as to measure the effectiveness of our documentation and whether users
      find what they're searching for. With your consent, you're helping us to
      make our documentation better.
    actions:
      - accept
      - manage
      - reject
    cookies:
      analytics:
        name: Google Analytics
        checked: false
      github:
        name: Github
        checked: false
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/telemetryforge
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/telemetry-forge
    - icon: fontawesome/solid/paper-plane
      link: mailto:info@telemetryforge.io
copyright: >
  Copyright © 2025 - 2026 Telemetry Forge
  <a href="#__consent">Change cookie settings</a>

validation:
  omitted_files: warn
  absolute_links: warn  # Or 'relative_to_docs' - new in MkDocs 1.6
  unrecognized_links: warn
  anchors: warn  # New in MkDocs 1.6