lec-lerka/translation-review

Übersetzungsprüfung, eine Sprache nach der anderen

translation-check stellt sicher, dass jeder Schlüssel mit den richtigen Platzhaltern existiert. Dieses Skill liest die Wörter.

1. Umfang und Kontext

• Welche Texte: die Schlüssel, die eine Änderung hinzugefügt oder bearbeitet hat (Diff der Lokalisierungsdateien gegen den Basis-Branch) oder ein gesamter Namespace bzw. eine Datei, falls gewünscht. Den Referenzwert und jeden Sprachwert nebeneinander abrufen.
• Wo sie erscheinen: die Verwendung jedes Schlüssels im Code finden (git grep "<key>"). Handelt es sich um einen Button, einen Titel, eine E-Mail, eine Fehlermeldung, einen Tooltip? Wie viel Platz steht zur Verfügung? Steht er in einem Satz mit anderen Schlüsseln oder enthält er einen {{count}}, einen Namen, ein Datum?
• Projektregeln: AGENTS.md und .claude/translations.json – für Wörter, die vermieden werden sollen, Produkt- und Plannamen, die unübersetzt bleiben, die Höflichkeitsform und wer der Leser ist (Kunde, Händler, Admin).
• Vorhandenes Glossar: wie dieselben Begriffe bereits an anderer Stelle in der jeweiligen Sprachdatei übersetzt wurden. git grep nach einem Begriff in diesem Locale-Ordner. Konsistenz geht vor eigener Präferenz.

2. Jede Sprache einzeln prüfen

Für jede Sprache jeden Text auf folgende Punkte prüfen:

1. Bedeutung: sagt dasselbe wie der Referenztext. Nichts hinzugefügt, nichts weggelassen, keine falschen Freunde. Platzhalter werden in der richtigen grammatischen Rolle verwendet.
2. Natürlichkeit: liest sich wie ein eigener Produkttext dieser Sprache, nicht wie Wort-für-Wort-Englisch. Auf Wortstellung, Artikel und Großschreibung achten (deutsche Substantive groß; kein englischer Title Case in anderen Sprachen).
3. Begriffe: dieselbe Sache hat überall denselben Namen (Bericht, Bestellung, Guthaben, VIN, Plannamen) und stimmt mit dem Glossar aus Schritt 1 überein.
4. Höflichkeitsform: ein einheitliches Register im gesamten Produkt, z. B. Sie oder du im Deutschen, ви im Ukrainischen, vous im Französischen, Vy im Tschechischen, Pan/Pani oder die neutralen Formen im Polnischen. Nicht mischen.
5. Grammatik mit Variablen: Pluralformen korrekt für reale Anzahlen (1, 2, 5, 21, 22, 25 in uk, pl und cs); Kasus nach Präpositionen; Genus-Kongruenz, wenn ein Platzhalter ein Nomen ist.
6. Länge: Buttons, Tabs und Badges bleiben ungefähr so kurz wie der Referenztext. Alles, was etwa 40% länger ist auf engem Raum, markieren.
7. Lokale Konventionen: Einheiten (km, kW, PS in de), Dezimalkomma, Datumsreihenfolge, Währungsposition, Anführungszeichen („…“ in de, « … » in fr, «…» in uk).
8. Projektregeln: verbotene Wörter, Schreibweise der Marke, Plannamen.

3. Bericht

Nach Sprache gruppieren und für jeden Befund den Schlüssel, den aktuellen Text, das Problem und einen Vorschlag angeben:

de — 2 Befunde
- reportPage:upgrade.cta — "Önvitî do Complete zvítu" — Wortstellung wirkt wie Englisch; Complete ist ein Planname → "Wechseln zum Complete-Bericht"
- ...
fr — keine Befunde

• Angeben, welche Sprachen sicher beurteilt werden können. Bei Sprachen, die nicht sicher beherrscht werden, dies ehrlich sagen und eine muttersprachliche Überprüfung vorschlagen.
• Falls gewünscht, die Korrekturen in den Lokalisierungsdateien anwenden, i18n:translation-check erneut ausführen und mit dem Change committen.
• In einer PR-Überprüfung diese Befunde als „Nits“ posten, es sei denn, die Bedeutung ist falsch oder ein verbotenes Wort taucht auf – dann als „Important“ kennzeichnen.