Zum Inhalt

Entwicklung

Für alle, die am Code mithelfen, Tests laufen lassen oder die Dokumentation lokal bauen wollen.

  • Setup & Tests

    Editierbare venv, schnelles Re-Install via pipx, Test-Suite ausführen.

  • Dokumentation

    Diese Doku lokal bauen und live previewen.

  • Repo-Struktur

    Wo liegt was im Repo? Modul-Layout, geteilte Bibliothek, Assets.

Beitragen

Issues und Pull Requests sind willkommen — speziell:

  • Bug-Reports mit minimalem Reproduktionsbeispiel (Eingabe-PDF, Befehl, erwartetes vs. tatsächliches Verhalten).
  • Aliase-Vorschläge: wenn noten-tools-aliases sync einen YAML-Patch ausgibt, der nicht im Repo ist, gerne als PR oder Issue mit dem YAML-Block einreichen — siehe OCR-Aliase pflegen.
  • Distro-Support: install.sh deckt Arch/CachyOS, Debian/Ubuntu, Fedora und macOS ab. Andere Distributionen sind möglich, brauchen aber Tests.