diff --git a/docs/konzept/08_repo_einrichten.md b/docs/konzept/08_repo_einrichten.md
index d7ed0f3..eeeb79a 100644
--- a/docs/konzept/08_repo_einrichten.md
+++ b/docs/konzept/08_repo_einrichten.md
@@ -38,12 +38,11 @@ Wir beginnen bewusst auf `unstable`, damit auch dieses Repository dem Kanal-Mode
 
 **Vor dem Push prüfen:**
 
-- [ ] **Autor des Commits stimmt.** `git log -1 --format='%an <%ae>'` – der vorbereitete Commit trägt die
-      Identität, die auf dem vorbereitenden Rechner in `git config --global` eingetragen war. Ist das nicht die
-      dienstliche Adresse, vor dem Push korrigieren:
+- [ ] **Autor des Commits stimmt.** `git log -1 --format='%an <%ae>'` – erwartet wird die Adresse des
+      Gitea-Kontos, weil Gitea Commits darüber dem Benutzer zuordnet. Stimmt sie nicht, vor dem Push korrigieren:
       ```bash
-      git config user.name "Vorname Nachname"
-      git config user.email "dienstliche@adresse"
+      git config user.name  "Vorname Nachname"
+      git config user.email "vorname.nachname@lfulg.sachsen.de"
       git commit --amend --reset-author --no-edit
       ```
 - [ ] `git status` zeigt keine Plugin-Ordner (`Plugin_SN_*`, `Repository`, `Linkliste`, `Defaults`)
diff --git a/docs/leitfaden/04_werkzeuge_einrichten.md b/docs/leitfaden/04_werkzeuge_einrichten.md
index e55480d..0393dc8 100644
--- a/docs/leitfaden/04_werkzeuge_einrichten.md
+++ b/docs/leitfaden/04_werkzeuge_einrichten.md
@@ -42,10 +42,21 @@ umsetzen.
   und den Credential Manager, der sich das Gitea-Token nach dem ersten Push merkt. Claude Code setzt Git for
   Windows voraus.
 - **macOS/Linux:** Git über Xcode-Tools bzw. die Paketverwaltung.
-- Einmalig einstellen:
+- Einmalig einstellen — **die E-Mail-Adresse muss die des Gitea-Kontos sein.** Gitea ordnet Commits über die
+  Adresse dem Benutzerkonto zu; passt sie nicht, erscheinen die Commits im Browser ohne Zuordnung und ohne
+  Profilbild, und niemand sieht, wer etwas geändert hat. Nachträglich lässt sich das nur durch Umschreiben der
+  Historie korrigieren.
   ```bash
-  git config --global user.name "Vorname Nachname"
-  git config --global user.email "dienstliche@adresse"
+  git config --global user.name  "Vorname Nachname"
+  git config --global user.email "vorname.nachname@lfulg.sachsen.de"
+  ```
+  Wer den Rechner auch privat nutzt, setzt die dienstliche Adresse besser **je Repository** statt global —
+  `--local` statt `--global`, in jedem Klon einmal. `python scripts/hallo.py` meldet nichts dazu; prüfen mit
+  `git config user.email` im jeweiligen Ordner.
+
+- Prüfen, bevor der erste Commit entsteht:
+  ```bash
+  git -C AG_QGIS config user.email     # muss die Gitea-Adresse sein
   ```
 
 ### 2.3 Python
@@ -226,6 +237,7 @@ Wer zusätzlich Code-Vervollständigung für die QGIS-API möchte, ergänzt die
 ## 7. Prüfliste „Einrichtung fertig"
 
 - [ ] `git --version` und `python --version` (≥ 3.11) laufen, `python -c "import openpyxl"` ohne Fehler
+- [ ] `git config user.email` im Ordner `AG_QGIS` liefert die Adresse des Gitea-Kontos
 - [ ] `AG_QGIS/` mit allen Repos vorhanden, `python scripts/setup_workspace.py` ohne Fehler
 - [ ] `python scripts/run_tests.py` zeigt drei Suiten mit den Baseline-Zahlen
 - [ ] `python scripts/hallo.py` läuft und zeigt den Stand aller Klone
diff --git a/docs/wissen/fallstricke.md b/docs/wissen/fallstricke.md
index 98a1add..5765bf0 100644
--- a/docs/wissen/fallstricke.md
+++ b/docs/wissen/fallstricke.md
@@ -23,6 +23,8 @@ Kurz, konkret, mit Datum und Quelle. Neue Einträge oben in der passenden Rubrik
 - **Modale Dialoge blockieren den Test.** Reihenfolge der Gegenmittel: modalen Aufruf per `monkeypatch` ersetzen, `open()` statt `exec()`, erst zuletzt `QTimer.singleShot`. (04.09.2026)
 - **Unter Windows nur `python-qgis.bat`/`python-qgis-ltr.bat` verwenden** – ein normales `python -m pytest` findet die QGIS-Bindings nicht. (04.09.2026)
 
+- **Gitea ordnet Commits über die E-Mail-Adresse zu.** Stimmt `user.email` nicht mit einer im Gitea-Konto hinterlegten Adresse überein, erscheinen die Commits ohne Zuordnung zum Benutzer. Für dieses Projekt gilt die dienstliche Adresse (`@lfulg.sachsen.de`). Wer den Rechner auch privat nutzt, setzt sie je Repository mit `git config --local` statt global. Nachträglich nur durch Umschreiben der Historie korrigierbar. (04.09.2026)
+
 ## Release und Versionen
 
 - **Der Release-Workflow baut den Kopf des Kanal-Branches**, nicht den getaggten Commit (`git checkout "$CHANNEL"` in `Repository:hidden/workflows`). Tag nur setzen, wenn der Kanal-Branch auf dem gewünschten Stand ist. (09/2026)