mkdocs.yml

site_name: DraftForge
site_description: Documentation for DraftForge - Dota 2 Tournament Management
site_url: https://dota.kettle.sh/docs

repo_name: kettleofketchup/draftforge
repo_url: https://github.com/kettleofketchup/draftforge

theme:
  name: material
  icon:
    repo: fontawesome/brands/github
  palette:
    - scheme: slate
      primary: deep purple
      accent: amber
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
    - scheme: default
      primary: deep purple
      accent: amber
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
  features:
    - navigation.tabs
    - navigation.sections
    - navigation.expand
    - navigation.top
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.code.annotate

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/kettleofketchup/draftforge
      name: GitHub Repository
    - icon: material/bug
      link: https://github.com/kettleofketchup/draftforge/issues/new?template=bug_report.md
      name: Report a Bug
    - icon: material/book-open-variant
      link: https://dota.kettle.sh/docs
      name: Live Documentation

plugins:
  - search
  - tags
  - panzoom

exclude_docs: |
  plans/

markdown_extensions:
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets:
      base_path:
        - docs
      check_paths: true
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - admonition
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - attr_list
  - md_in_html
  - tables
  - toc:
      permalink: true

nav:
  - Home: index.md
  - Getting Started:
      - Installation: getting-started/installation.md
      - Quick Start: getting-started/quick-start.md
  - Features:
      - Draft System: features/draft.md
      - Hero Draft: features/herodraft.md
      - Bracket: features/bracket.md
      - CSV Import: features/csv-import.md
      - Events:
          - Overview: features/events.md
          - Roll Call: features/events/roll-call.md
      - Planned:
          - Overview: features/planned/index.md
          - Team Management & Seasons: features/planned/team-management.md
          - League Rating: features/planned/league-rating.md
          - Dota 2 Lobbies: features/planned/dota-lobbies.md
          - Discord Integration: features/planned/discord-integration.md
          - Auction House: features/planned/auction-house.md
          - CSV Import: features/planned/csv-import.md
  - Architecture:
      - Overview: architecture/overview.md
      - Docker Setup: architecture/docker.md
      - Backend: architecture/backend.md
      - Frontend: architecture/frontend.md
      - User Entity Cache: architecture/user-entity-cache.md
      - Event Reminder Scheduling: architecture/event-reminder-scheduling.md
  - Development:
      - Backend Quickstart: development/backend-quickstart.md
      - Just Commands: development/just-commands.md
      - Invoke Tasks (Legacy): development/invoke-tasks.md
      - Testing: development/testing.md
      - Contributing: development/contributing.md
      - Theming Guide: THEMING-GUIDE.md
      - Demo Videos: ai/demo/index.md
      - Telemetry:
        - Overview: dev/telemetry/index.md
        - Architecture: dev/telemetry/architecture.md
        - Logging Guide: dev/telemetry/logging.md
        - Tracing Guide: dev/telemetry/tracing.md
        - Context Guide: dev/telemetry/context.md
        - Local Observability: dev/telemetry/local-observability.md
        - Reference: dev/telemetry/reference.md
      - Auth:
        - "Roles & Permission Matrix": dev/auth/roles.md
      - Testing Reference:
        - Cypress Tests (Legacy): dev/testing/cypress-tests.md
        - Playwright: testing/playwright.md
        - Test Tournaments: testing/test-tournaments.md
        - Auth Fixtures: testing/auth/fixtures.md
  - API Reference:
      - Endpoints: api/endpoints.md
  - Links:
      - "Live Site": https://dota.kettle.sh/
      - "Report Bug": https://github.com/kettleofketchup/draftforge/issues/new?template=bug_report.md
      - "GitHub": https://github.com/kettleofketchup/draftforge