From 767f2104c3b29844cbac7fb80de021901641188f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20Tr=C3=B6ger?= Date: Mon, 10 Aug 2026 07:15:01 +0200 Subject: [PATCH] docs: Kommentare im Code auf eine Zeile begrenzen Ein Kommentar beschreibt kurz, was an dieser Stelle passiert. Das Warum gehoert in die Commit-Message und ist dort in der Git-Historie nachlesbar. Co-Authored-By: Claude Opus 5 --- dotfiles/CLAUDE.md | 1 + 1 file changed, 1 insertion(+) diff --git a/dotfiles/CLAUDE.md b/dotfiles/CLAUDE.md index 8839218..aaabe15 100644 --- a/dotfiles/CLAUDE.md +++ b/dotfiles/CLAUDE.md @@ -23,6 +23,7 @@ Alle Texte, Kommentare und Kommunikation auf Deutsch. Technische Begriffe und Co - **Security by Default:** Input-Validierung, Auth-Checks, sichere Defaults. Sicherheitskritische Pfade durch Tests absichern - **String-Eingaben trimmen:** Alle String-Felder beim Anlegen/Update in Services/Schemas trimmen (leading/trailing Whitespace entfernen). Leerstrings werden zu `None`, wenn das Feld optional ist. Verhindert Sortier-/Vergleichs-/Suchfehler durch unsichtbare Zeichen - **Kleine Funktionen, keine Kommentare fuer Offensichtliches** +- **Kommentare hoechstens eine Zeile:** Ein Kommentar beschreibt kurz, *was* an dieser Stelle passiert (z.B. `// Messwerte pruefen`, `// zu spaet fuer Sperre`, `// Ladestand unterhalb Reserve`). Niemals das *Warum*, keine Begruendungen, keine Messwerte, keine verworfenen Alternativen, keine Mehrzeiler. Das Warum gehoert in die Commit-Message und ist dort in der Git-Historie nachlesbar - **Keine systemveraendernden Scripts zum Testen ausfuehren:** Scripts die Symlinks, Berechtigungen, Pakete oder Konfiguration aendern niemals "einfach so" ausfuehren. Stattdessen mit `bash -n` (Syntax) oder gezieltem `grep`/`cat` pruefen ## Code-Konventionen