@@ -0,0 +1,142 @@
+# Glossar der deutschen Python-Dokumentation
+
+Diese Liste hält fest, wie wiederkehrende Fachbegriffe im Deutschen heißen.
+Sie richtet sich an alle, die an der Übersetzung mitarbeiten – egal ob über
+GitHub oder über Transifex.
+
+Die Regeln zur reST-Auszeichnung, zu Codeblöcken und zum Prüfablauf stehen
+nicht hier, sondern in [AI-SKILLS.md](AI-SKILLS.md).
+
+## Was im Zweifel entscheidet
+
+1. **`glossary.po`.** Wer einen Begriff übersetzt, der im Python-Glossar
+   ein eigenes Stichwort hat, nimmt die dortige Fassung. Das Glossar ist
+   die veröffentlichte Begriffsliste, auf die Leser verwiesen werden.
+2. **Dieses Glossar.** Für alles, was im Python-Glossar nicht vorkommt.
+3. **Der Bestand im Repo.** Gibt es weder dort noch hier eine Festlegung,
+   lohnt ein Blick darauf, wie der Begriff schon übersetzt wurde. Ein
+   `grep` über die `.po`-Dateien beantwortet das meist in einer Minute.
+4. **Neu entscheiden.** Dann aber bitte die Entscheidung hier eintragen,
+   damit die nächste Person nicht wieder von vorn anfängt.
+
+Ein eigener Begriff lässt sich **nicht** in `glossary.po` ergänzen: Jeder
+Eintrag dort hängt an einem `msgid` aus `Doc/glossary.rst` in CPython.
+Soll ein Begriff wirklich ins veröffentlichte Glossar, führt der Weg über
+einen Pull Request gegen CPython; beim nächsten Sync steht er dann allen
+Sprachen zur Verfügung.
+
+## Grundhaltung
+
+- Durchgehend **Du**-Form, niemals „Sie".
+- Funktionsbeschreibungen in der 3. Person: „Gibt … zurück", nicht
+  „Gib … zurück".
+- Kapitelüberschriften der Form „… Services" werden zu „Dienste …":
+  „Dienste der Python-Laufzeitumgebung", „Dienste zur Textverarbeitung",
+  „Dienste für die Python-Sprache".
+- Lieber ein etabliertes Lehnwort als eine selbstgebaute Eindeutschung.
+  Ein Begriff muss nachschlagbar bleiben: Wer „Factory-Funktion" liest,
+  findet beim Suchen etwas, wer „Fabrikfunktion" liest, nicht.
+
+## Begriffe
+
+| Englisch | Deutsch | Anmerkung |
+|---|---|---|
+| archive member | Archiveintrag | nicht „Archivmitglied" |
+| auditing event | Auditing-Ereignis | „audit event" im Fließtext ohne Rolle → „Audit-Ereignis" |
+| broadcast address | Broadcast-Adresse | |
+| built-in | integriert | nicht „eingebaut" |
+| canvas | Zeichenfläche | |
+| central directory | zentrales Verzeichnis | ZIP-Fachbegriff |
+| code object | Code-Objekt | mit Bindestrich, nicht „Codeobjekt" |
+| comprehension | Comprehension | nie „Kompression" oder „Abstraktion" |
+| convenience function | Hilfsfunktion | |
+| decompression bomb | Entpackbombe | „ZIP bomb" bleibt als benannter Verweis englisch |
+| decorator | Dekorator | nicht „Decorator", erst recht nicht „Dekorateur" |
+| dictionary | Dictionary | Plural „Dictionarys"; „dictionary view" → „Dictionary-View" |
+| display (list/set/dict) | Display | nicht „Anzeige"; „Wörterbuch-Display" |
+| event loop | Ereignisschleife | |
+| exploded / compressed (IP) | ausgeschrieben / verkürzt | |
+| factory function | Factory-Funktion | „factory" allein → „Factory", Plural „Factorys" |
+| font | Schriftart | nicht „Schrift" |
+| free-threaded build | Build mit freien Threads | laut Glossar |
+| host mask | Hostmaske | |
+| iterable | Iterable | nicht „iterierbares Objekt" |
+| lazy import | verzögerter Import | |
+| look and feel | Aussehen und Verhalten | |
+| main window | Hauptfenster | |
+| namespace package | Namespace-Paket | nicht „Namensraum-Paket" |
+| net mask | Netzmaske | |
+| numeric tower | numerischer Turm | |
+| octet | Oktett | |
+| path traversal | Pfadwechsel | |
+| to pickle | serialisieren | nie „picklen"; das Substantiv „Pickle" bleibt (Pickle-Datei, Pickle-Funktion) |
+| prefix / prefix length | Präfix / Präfixlänge | |
+| probe point | Probepoint | DTrace/SystemTap |
+| root window | Root-Fenster | nicht „Wurzelfenster" |
+| scope zone ID | Scope-Zone-ID | |
+| seekable | positionierbar | |
+| soft keyword | weiches Schlüsselwort | |
+| string | Zeichenkette | siehe „Offene Punkte" |
+| subnet / supernet | Subnetz / Supernetz | |
+| subscription expression | Indexausdruck | nicht „Abonnementausdruck" |
+| themed widgets | Widgets mit Themes | |
+| thread state | Thread-Zustand | nicht „Thread-Status"; „attached" dazu → „angehängt" |
+| toplevel window | Toplevel-Fenster | |
+| universal newlines | universelle Zeilenumbrüche | |
+| unraisable exception | nicht weiterleitbare Ausnahme | beim ersten Vorkommen mit englischem Begriff in Klammern, danach kurz |
+| wrapper | Hülle | |
+
+### Kind-
+
+„child" bleibt als Stamm „Kind-", steht aber nie allein. Immer als
+Kompositum mit dem gemeinten Ding: „Kindeintrag" (Treeview),
+„Kind-Widget" (Widget-Hierarchie), „Kind-Logger" (Logger-Hierarchie),
+„Kindknoten" (abstrakter Baum). Das nackte „Kinder" und „Kinderliste"
+sind falsch. Bestehende Komposita wie Kindprozess, Kindklasse und
+Kindfenster bleiben.
+
+## Begriffe, die englisch bleiben
+
+Widget, Frame, Toplevel, Callback, Scrollbar, Tag, Mixin, Theme, Turtle,
+Boilerplate, Loopback, Multicast, Big-Endian.
+
+Dazu immer: Funktions-, Klassen-, Methoden- und Parameternamen, Typnamen
+aus C, Schlüsselwörter und alles, was in ``doppelten Backticks`` steht.
+
+## Zwei Dinge, die beide „Template" heißen
+
+Das ist die häufigste Verwechslung in diesem Projekt, und sie betrifft
+zwei verschiedene Sprachmerkmale:
+
+- **`string.Template` mit `$`-Ersetzung** (seit Python 2.4) →
+  **Vorlage-Zeichenkette**, die Überschrift lautet
+  „Vorlage-Zeichenketten ($-Zeichenketten)".
+- **t-Strings aus PEP 750** (seit Python 3.14) →
+  **Template-String-Literal**, kurz **t-String**. Das Modul heißt
+  „Unterstützung für Template-String-Literale".
+
+Beide Begriffe nebeneinander stehen zu lassen ist Absicht: Zwei
+verschiedene Dinge brauchen zwei verschiedene Namen. Wer hier
+vereinheitlicht, macht die Dokumentation unverständlich.
+
+## Offene Punkte
+
+Diese Fragen sind noch nicht entschieden. Wer darauf stößt, möge die
+vorhandene Schreibweise der Datei beibehalten und hier Bescheid geben,
+statt im Alleingang umzustellen.
+
+**„string" → „Zeichenkette" oder „String"?** Die Regel oben sagt
+„Zeichenkette", der Bestand sagt etwas anderes: Allein in
+`builtins/stdtypes.po` stehen 194 Fundstellen „String" gegen 24
+„Zeichenkette". Die Angleichung wäre ein eigener Durchgang über mehrere
+große Dateien. Bis dahin gilt: In einer Datei durchhalten, was dort schon
+steht.
+
+**Qualifizierte Comprehension-Formen.** Im Repo stehen 38 Fundstellen in
+18 Schreibweisen; allein „list comprehension" kommt in sieben Varianten
+vor. Das Glossar schreibt „List Comprehension", „Dictionary Comprehension"
+und „Set Comprehension" – also englisch mit Leerzeichen –, das wäre die
+Zielform. Betroffen sind neun Dateien, darunter `builtins/stdtypes.po`,
+`glossary.po`, `howto/functional.po` und `reference/expressions.po`. Das
+unqualifizierte „Comprehension" ist überall einheitlich und nicht
+betroffen.