Merge branch '3.15' into claude/check-build-tools-656068

Author: sba72

CLAUDE.md

@@ -0,0 +1,43 @@
+# Übersetzungsregeln für python-docs-de
+
+Dieses Repository enthält die deutsche Übersetzung der Python-Dokumentation
+als Gettext-Dateien (`.po`). Übersetzt wird ausschließlich der `msgstr`.
+
+## Sprache und Terminologie
+- Durchgehend „Du"-Form, niemals „Sie"
+- „Built-in" → „integriert"
+- „dictionary" → „Dictionary" (nicht „Wörterbuch")
+- „string" → „Zeichenkette" (nicht „String" oder „Zeichenfolge")
+- „iterable" → „iterierbares Objekt"
+- Funktionsbeschreibungen in der 3. Person: „Gibt … zurück"
+- Deutsche Anführungszeichen „…“, nie um Rollen oder Code herum
+- „unraisable exception" → „nicht weiterleitbare Ausnahme
+  (unraisable exception)" beim ersten Vorkommen, danach kurz
+- „free-threaded build" → „Build mit freien Threads" (laut Glossar)
+- Bei Fachbegriffen ist `glossary.po` maßgeblich. Im Zweifel dort
+  nachschlagen, bevor ein Begriff neu übersetzt wird.
+
+## reST- und PO-Syntax
+- `msgid` NIEMALS ändern, auch nicht bei Tippfehlern im Original
+- Rollen (`:func:`, `:class:`, `:ref:`, `:term:`, `:meth:`, `:exc:`)
+  exakt übernehmen; Anzahl und Reihenfolge müssen msgid und msgstr
+  entsprechen
+- Bei `:term:` und `:ref:` mit deutschem Anzeigetext immer das Ziel
+  angeben: `:term:`Sequenz <sequence>``
+- Parameternamen zwischen Sternchen bleiben englisch: *maxsplit*
+- Nach `` ` `` oder `*` nie direkt ein Buchstabe oder Bindestrich
+  (kein `*m*s`, kein `:class:`X`-Instanz`)
+- Vor einer Rolle immer ein Leerzeichen
+- Code-Literale, Programmausgaben und `::` am Zeilenende unverändert
+- `#, fuzzy` nach dem Übersetzen entfernen
+
+## Prüfungen nach jedem Abschnitt
+    powrap <datei>
+    msgfmt --check -o /dev/null <datei>
+    sphinx-lint <datei>
+    python3 check_roles.py <datei>
+
+Gemeldete Fehler beheben und die Prüfungen erneut ausführen –
+höchstens drei Versuche. Bleiben danach Fehler bestehen: nicht
+committen, sondern die betroffenen Einträge und die Fehlermeldungen
+auflisten und auf Rückmeldung warten.

TODO.md

@@ -3751,15 +3751,15 @@ msgid ""
 "<slicings>` form of :ref:`subscript notation <subscriptions>`, with colons "
 "inside square brackets, such as in ``variable_name[1:3:5]``."
 msgstr ""
-"Ein Objekt vom Typ :class:`slice`, das zur Beschreibung eines Teils einer :"
-"term:`Sequenz <sequence>` dient. Ein Slice-Objekt wird erstellt, wenn die :"
-"ref:`Slicing- <slicings>` -Form der :ref:`Indexnotation <subscriptions>` "
-"verwendet wird, bei der Doppelpunkte in eckigen Klammern stehen, wie "
-"beispielsweise in ``variable_name[1:3:5]``."
+"Ein Objekt vom Typ :class:`slice`, das zur Beschreibung eines Teils einer "
+":term:`Sequenz <sequence>` dient. Ein Slice-Objekt wird erstellt, wenn die "
+"Form des :ref:`Slicings <slicings>` der :ref:`Indexnotation "
+"<subscriptions>` verwendet wird, bei der Doppelpunkte in eckigen Klammern "
+"stehen, wie beispielsweise in ``variable_name[1:3:5]``."
 
 #: ../../glossary.rst:1483
 msgid "soft deprecated"
-msgstr "weich veraltet"
+msgstr "sanft abgekündigt"
 
 #: ../../glossary.rst:1485
 msgid ""
@@ -3934,12 +3934,12 @@ msgid ""
 "subscripting a :term:`mapping`, or an :term:`index` when subscripting a :"
 "term:`sequence`."
 msgstr ""
-"Der Ausdruck in eckigen Klammern eines :ref:`Abonnementausdrucks "
-"<subscriptions>`, zum Beispiel der ``3`` in ``items[3]``. Wird in der Regel "
-"verwendet, um ein Element eines Containers auszuwählen. Wird auch als :term:"
-"`Schlüssel <key>` bezeichnet, wenn ein :term:`Mapping <mapping>` indiziert "
-"wird, oder als :term:`Index <index>`, wenn eine :term:`Sequenz <sequence>` "
-"indiziert wird."
+"Der Ausdruck in eckigen Klammern eines :ref:`Indexausdrucks "
+"<subscriptions>`, zum Beispiel die ``3`` in ``items[3]``. Wird in der Regel "
+"verwendet, um ein Element eines Containers auszuwählen. Wird auch als "
+":term:`Schlüssel <key>` bezeichnet, wenn auf ein :term:`Mapping <mapping>` "
+"zugegriffen wird, oder als :term:`Index <index>`, wenn auf eine "
+":term:`Sequenz <sequence>` zugegriffen wird."
 
 #: ../../glossary.rst:1555
 msgid "synchronization primitive"