Übersetzungen

Diese Dokumentation ist auf Englisch verfasst. Damit sie mehr Menschen nützt, veröffentlichen wir zusätzlich maschinell übersetzte Ausgaben davon. Diese Seite erklärt, was das für dich bedeutet und wie du helfen kannst, sie zu verbessern.

Was verfügbar ist

Die übersetzte Dokumentation ist derzeit eine Vorschau in zwölf Sprachen: Deutsch, español, français, हिन्दी, 日本語, 한국어, português (Brasil), русский язык, Türkçe, українська мова, 简体中文 und 繁體中文. Wähle eine über die Sprachauswahl oben auf jeder Seite. Weitere Sprachen können folgen, sobald sich diese bewährt haben.

Die API-Referenz wird nicht übersetzt: Die übersetzte Website verlinkt auf die eine englische Fassung.

Maßgeblich ist die englische Fassung

Wenn eine übersetzte Seite und ihr englisches Original voneinander abweichen, gilt die englische Seite. Jede Seite einer übersetzten Website beginnt mit einem von drei Hinweisen, der ihren Stand angibt:

• Maschinelle Übersetzung – die Seite wurde automatisch übersetzt und verlinkt auf ihr englisches Original.
• Übersetzung hinter der englischen Seite zurück – das englische Original hat sich geändert, nachdem die Seite übersetzt wurde; Teile davon können also veraltet sein, bis die Übersetzung nachzieht.
• Auf Englisch angezeigt – es gibt keine aktuelle Übersetzung der Seite, deshalb liest du den englischen Text.

Wie die Übersetzungen entstehen

Übersetzte Seiten erzeugt ein Tool in diesem Repository maschinell aus den englischen Seiten unter docs/, gesteuert von zwei von Menschen geschriebenen Vorgaben pro Sprache: einem Styleguide (Anrede, Tonfall, Typografie, Umgang mit Witzen und Redewendungen) und einem Glossar (welche Begriffe auf Englisch bleiben sowie die vorgeschriebenen und verbotenen Wiedergaben für den Rest). Der erzeugte Text wird nie von Hand bearbeitet. Jede Verbesserung fließt stattdessen in diese Vorgaben ein, damit sie die nächste Neuerzeugung der Seiten übersteht.

Ein Übersetzungsproblem melden

Einen falschen Begriff, einen holprigen Satz oder eine Übersetzung gefunden, die etwas anderes sagt als das Englische? Eröffne ein Issue mit der Sprache, der Seite und der Textstelle; Meldungen von Menschen mit der jeweiligen Muttersprache sind besonders wertvoll. Wenn du die Korrektur kennst, schlage sie direkt als Pull Request gegen den Styleguide (instructions.md) oder das Glossar (glossary.json) der jeweiligen Sprache unter i18n/ vor – die Korrektur erreicht dann jede betroffene Seite, sobald die Übersetzungen das nächste Mal neu erzeugt werden. Probleme mit dem englischen Text selbst werden in den Seiten unter docs/ behoben, wie jede andere Änderung an der Dokumentation.