Technische Dokumentation übersetzen: GitHub, Stack Overflow und mehr
Technische Dokumentation übersetzen: GitHub, Stack Overflow und mehr
Wer programmiert, liest Englisch. Das ist einfach so. Die besten Antworten auf Stack Overflow, die ausführlichsten READMEs auf GitHub, die aktuellsten Docs auf MDN – fast alles ist auf Englisch. Für Entwickler mit soliden Englischkenntnissen kein Problem. Aber für alle anderen, und das sind mehr, als man denkt, ist die Sprachbarriere eine echte Hürde im Arbeitsalltag.
Das Problem mit Ganzseitenübersetzung bei Code
Der naheliegende Griff zur Browser-Übersetzung endet bei technischen Seiten regelmäßig im Desaster. Die Übersetzung unterscheidet nicht zwischen Fließtext und Code. Variablennamen werden eingedeutscht, Terminalbefehle verstümmelt, und aus return wird plötzlich „Rückkehr". Wer einmal einen übersetzten Stack-Overflow-Beitrag gelesen hat, in dem array.push() zu „Array.drücken()" wurde, weiß, warum das keine Option ist.
Das Problem liegt daran, dass allgemeine Übersetzer nicht verstehen, was Code ist und was Prosa. Sie behandeln alles gleich, und genau das macht technische Dokumentation zu einem der schwierigsten Anwendungsfälle für maschinelle Übersetzung.
Was gute Übersetzung bei Tech-Inhalten leisten muss
Ein brauchbares Tool für technische Dokumentation muss drei Dinge können. Erstens: Code-Blöcke, Inline-Code und Terminalbefehle unangetastet lassen. Zweitens: Fachbegriffe konsistent übersetzen oder bewusst im Original belassen, denn kein deutscher Entwickler sagt „Zusammenführungsanfrage" statt „Merge Request". Drittens: den Kontext der Erklärung verstehen, damit die Übersetzung des umgebenden Textes tatsächlich hilft und nicht verwirrt.
KI-gestützte Übersetzungen sind hier einen großen Schritt weiter als die alten regelbasierten Systeme. Ein modernes Sprachmodell erkennt in den meisten Fällen, dass docker-compose up -d ein Befehl ist und kein zu übersetzender Satz. Perfekt ist das noch nicht, aber der Unterschied zu vor drei Jahren ist enorm.
GitHub, Stack Overflow, MDN – wo die Übersetzung am meisten hilft
Auf Stack Overflow steht die Erklärung um den Code herum oft im Mittelpunkt. Du verstehst die Code-Zeilen, aber der Absatz, der erklärt, warum diese Lösung funktioniert und die andere nicht, bleibt nebulös. Genau dieser Absatz ist es aber, der den Unterschied macht zwischen blindem Kopieren und echtem Verstehen.
Auf GitHub sind es die READMEs, die Issues und die Diskussionen in Pull Requests. Besonders bei Open-Source-Projekten, an denen man mitarbeiten möchte, ist es frustrierend, die technische Diskussion nur halb zu verstehen. Eine gute Übersetzung des Fließtexts, während der Code unberührt bleibt, macht den Einstieg in ein fremdes Projekt deutlich einfacher.
Auf MDN Web Docs und ähnlichen Referenzseiten gibt es zwar oft offizielle Übersetzungen, aber sie hinken der englischen Version hinterher. Wer die neueste API-Dokumentation braucht, liest zwangsläufig Englisch – oder lässt übersetzen.
Wie BothLang bei technischen Inhalten hilft
BothLang übersetzt den Fließtext einer Seite und zeigt ihn zweisprachig an, während Code-Blöcke und technische Formatierung erhalten bleiben. Das ist genau die Balance, die bei technischer Dokumentation nötig ist: Du verstehst die Erklärung auf Deutsch, der Code bleibt, wie er ist, und du musst nicht zwischen zwei Tabs hin- und herschalten.
Gerade für Entwickler, die ihre Englischkenntnisse nebenbei verbessern wollen, ist das zweisprachige Format ideal. Du liest die englische Erklärung, hast die deutsche Version als Absicherung daneben – und mit der Zeit brauchst du die immer seltener.