# files/ – Handbuecher & Dokumente direkt im Repo

Lege hier Handbuecher/Dokumente ab (PDF oder Markdown), die kein externer Link
sind – z.B. ein Tool-Handbuch, das jemand einfach ins Repo pusht.

Empfohlene Struktur: ein Unterordner je Tool/Domaene:
```
files/
  mein-tool/
    handbuch.pdf
    schnellstart.md
```

Im Katalog wird das ueber die Strategie `file` eingebunden:
```yaml
- id: mein-tool
  name: "Mein Tool"
  domain: mein-tool
  scope: intern
  owners: ["vorname.nachname@deutschebahn.com"]
  sources:
    - url: "files/mein-tool"      # Ordner (oder direkte Datei) im Repo
      strategy: file
      # options: { max_depth: -1 }   # Tiefe bei Unterordnern
```

`.md` wird direkt uebernommen, `.pdf` wird zu Text extrahiert. Die Dateien sind
versioniert (Git) – damit nachvollziehbar, wer was wann hinzugefuegt hat.