handbook/mkdocs.yml at main · ConductionNL/handbook · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
site_name: Conduction Handboek
site_url: https://conduction.codeberg.page/handbook/
repo_url: https://github.com/ConductionNL/handbook
# GitHub-syntax (`edit/`), niet Forgejo's `_edit/`: met repo_url op GitHub
# gaf `_edit/main/docs/...` een 404 op elke "bewerk deze pagina"-link.
edit_uri: edit/main/docs/

theme:
  name: material
  language: nl
  features:
    - navigation.sections
    - navigation.top
    - search.suggest
    - content.action.edit

# Aggregatie-invariant: content wordt at build time uit de bronrepos
# gekloond, nooit hierheen gekopieerd. Een repo toevoegen = één entry
# in de repos-lijst hieronder (expliciet en reviewbaar, geen discovery).
plugins:
  - search:
      lang:
        - nl
        - en
  - multirepo:
      # cleanup uit: de freshness-gate leest de geïmporteerde bomen na de
      # build (multirepo_imports/ staat in .gitignore).
      cleanup: false
      temp_dir: multirepo_imports
      # TRUST ROOT (zie docs/agents.md): deze lijst bepaalt wat portaal,
      # hub-MCP en agents als waarheid zien. Wijzigen is voorstel-eerst.
      #
      # Sinds 2026-08-03 GitHub (ConductionNL) i.p.v. Codeberg: de fleet is
      # terugmigreerd en de Codeberg-mirrors liepen achter — cluster-infra
      # stond daar nog op b5a7a38 terwijl GitHub op 007859b zat, dus de MCP
      # diende verouderde documentatie als grondwaarheid.
      #
      # Let op de casing: het laatste pad-segment ís de componentnaam die
      # agents aan `read_page` doorgeven en die in de bron-URL landt. Houd
      # het gelijk aan de canonieke GitHub-naam (`Talos`, `React-base`).
      repos:
        - section: Nextcloud-base
          import_url: 'https://github.com/ConductionNL/Nextcloud-base?branch=main&docs_dir=docs/*'
        - section: React-base
          import_url: 'https://github.com/ConductionNL/React-base?branch=main&docs_dir=docs/*'
        - section: talos (CI)
          import_url: 'https://github.com/ConductionNL/Talos?branch=main&docs_dir=docs/*'
        - section: cluster-infra
          import_url: 'https://github.com/ConductionNL/cluster-infra?branch=main&docs_dir=docs/*'
        # cluster-config (private repo) staat sinds 2026-08-03 bewust NIET
        # in de publieke site. De RCA noemde de clusternaam
        # (garden-…-con-prod-external), de provider en de tenant-inventaris;
        # die stonden publiek leesbaar op codeberg.page. Zelfde afweging als
        # KeyCloak hieronder. Agents houden toegang via de interne lijst in
        # hub (docs_mcp/internal_components.yaml) — publiek en grondwaarheid
        # zijn twee knoppen. Terug bij add-portal-access-split.
        # - section: cluster-config
        #   import_url: 'https://github.com/ConductionNL/cluster-config?branch=main&docs_dir=docs/*'
        - section: monitoring
          import_url: 'https://github.com/ConductionNL/monitoring?branch=main&docs_dir=docs/*'
        # KeyCloak (private repo) staat bewust NIET in de publieke site:
        # interne endpoints/klantkoppelingen horen achter login. Terug bij
        # openspec change add-portal-access-split (interne variant).
        # - section: KeyCloak
        #   import_url: 'https://github.com/ConductionNL/KeyCloak?branch=main&docs_dir=docs/*'
        - section: openwoo-app-config
          import_url: 'https://github.com/ConductionNL/openwoo-app-config?branch=main&docs_dir=docs/*'
        - section: hub
          import_url: 'https://github.com/ConductionNL/hub?branch=main&docs_dir=docs/*'