# OpenYield docs site (MkDocs Material, D-042).
#
# Build-only Python dep (mkdocs + mkdocs-material); NOT a Go dep (G-006 —
# go.mod stays zero-require). Invoke locally with `mkdocs serve` or
# `mkdocs build` (see README). No publishing CI in v0.3 (D-046 — publishing
# to GitHub/Gitea Pages deferred to v0.4).
#
# Nav completeness (G-011): the nav lists ALL 26 pages that will exist by end
# of P3. P1 creates the shared/ pages + index (8 files); P2 adds nomads/
# (8 files); P3 adds freeholders/ (8 files) + reference/ (2 files). Only the
# files that exist at P1 ship today; the nav references the not-yet-created
# P2/P3 pages by path so the structure is complete and P2/P3 just add files.
# mkdocs.yml is a config file, NOT validated by Go tests; the docs firewall
# (lexicon_meta_docs_test.go) validates .md content, not nav.

site_name: OpenYield
site_description: OpenYield — a jurisdiction-light, public-good mesh for real production, organized around Holders, Stands, and the Six Principles.

theme:
  name: material
  features:
    - navigation.sections
    - navigation.expand
    - toc.integrate

markdown_extensions:
  - admonition
  - toc:
      permalink: true
  - codehilite
  - pymdownx.superfences

nav:
  - Home: index.md
  - Nomads:
      - Overview: nomads/index.md
      - Reach: nomads/reach.md
      - Stash: nomads/stash.md
      - Bearers: nomads/bearers.md
      - Maps-Pay: nomads/maps-pay.md
      - Pacts: nomads/pacts.md
      - Standing: nomads/standing.md
      - Window: nomads/window.md
  - Freeholders:
      - Overview: freeholders/index.md
      - Signals: freeholders/signals.md
      - Standing: freeholders/standing.md
      - Stands & Guilds: freeholders/stands-guilds.md
      - Councils & Voice: freeholders/councils-voice.md
      - Bonds: freeholders/bonds.md
      - Partner Spectrum: freeholders/partner-spectrum.md
      - Anchor Preview: freeholders/anchor-preview.md
  - Shared:
      - Overview: shared/index.md
      - Six Principles: shared/six-principles.md
      - Bread Scale: shared/bread-scale.md
      - Storage Pools: shared/storage-pools.md
      - Watchers & Mirror: shared/watchers-mirror.md
      - Lexicon: shared/lexicon.md
      - Vision: shared/vision.md
  - Reference:
      - Architecture: reference/architecture.md
      - Components: reference/components.md