Experiment: German translation 🇩🇪🇨🇭🇦🇹#741
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
tl;drWe're launching an experimental German version of MDN, which is targeted to those that prefer to read MDN content in German rather than English. The content is automatically translated from English using OpenAI's latest GPT-4o model, and is now available on (developer.mozilla.org). The sources can be found in themdn/translated-content-de repository. Note: This is an experiment, and work in progress. Translations may contain inaccuracies. ![]() DetailsMDN was available in German (de) until August 2022, when we had to remove the locale, because it was incomplete, outdated, and no longer maintained. Although we hypothesized that there was still demand for the German locale, we saw no possibility to bring it back at the time: We had evaluated automatic translations as not good enough, and considered manual translation as impossible due to the volume of MDN content, and the pace at which it is updated. In April 2024, we re-evaluated our options, and identified LLM-based machine translation as a potential solution to revive the German locale, and to maintain it in a semi-automated way going forward. In May 2024, we ran initial tests with LLM-based machine translation from English to German, which confirmed that the approach yields sufficient results even with a simple prompt. In June 2024, we ran a survey (see results below) that confirmed interest in the German locale, and informed us about translation criteria, and user concerns. In September 2024, we launched the new experimentalRemember language feature, which we had identified as a blocker for the German locale in the survey. The feature effectively allows users to opt-out of the German locale. In October 2024, we launched the public preview of the German language in an isolated test environment. ExperimentIn November 2024, we're now launching the German language as an experiment on production (without exposure to search engines). This is thefirst fully-translated language covering all MDN Web Docs content with over 12'500 pages, translated from the English language using OpenAI's latest In December 2024, we started exposing the German translation to search engines. To provide feedback, please rate good and bad translations using the thumbs (👍👎) in the "MDN-Feedback-Box" below the articles. If you notice any issues, please use the "Report a problem with this translation" link, write uson Discord, comment below, or send us an email ( ![]() Translation processAs of December 4, 2024, the translation process includes a daily automated workflow that includes the following steps:
Next stepsWe believe that the machine-translated German locale is helpful in its current state, even if it may contain inaccuracies. For now, we gather user feedback, and aim to iterate on a weekly basis to address issues, and improve the quality of the translation, and the reliability of the translation process. Our vision is for German to become a regular translated locale, and the first locale to be maintained using a combination of machine translation, and community reviews. Appendix: SurveyIn June 2024, weran a survey on MDN for 5 days that was shown to all users whose browser preference indicated German as thepreferred language. GoalThe goal of the survey was to test our hypothesis that there is demand for the German language, understand our users' language proficiency and preference, translation priorities, and concerns. ParticipationThe survey was seen by over 60'000 users, and over 1'900 users completed it (3%). Language proficiency and preferenceWe asked about language proficiency:
(Note: German language preference correlated inversely with English language proficiency.) We asked what language they would use if MDN was available in German:
Translation prioritiesWe asked what would be important in a German version of MDN:
ConcernsWe asked an open-ended question, and 13% of participants answered it, providing context for their responses, or sharing concerns. Amongusers who indicated no preference or a preference for German there were no significant patterns, apart from praise and gratitude (n = 18; thank you!). Users who indicated a preference for English …
LimitationsThe main limitation of the survey is its appearance in the context of non-German content, so potential users who only speak German may be under-represented. On the other hand, users who are interested in the German locale may be more likely to respond to the survey, and therefore over-represented. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 5👎 23🎉 3❤️ 10
Replies: 17 comments 27 replies
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
Love howthis page in German encourages people to "make use of diarrhea" ("Ausnutzen des Durchfalls"). "AI" translations are really innovative stuff. /s Hire translators. |
BetaWas this translation helpful?Give feedback.
All reactions
❤️ 3👀 2
-
Microsoft can’t get their automatic translations up to quality, who own OpenAI, how’s MDN going to get this right? You’ll be constantly fighting with the model. Piece if Evidence A:„DLL Surrogate“ is not „DLL-Ersatzzeichen“. |
BetaWas this translation helpful?Give feedback.
All reactions
-
Thank you for trying out theexperimental German translation, and for taking the time to provide this feedback. 🙌
First of all, great catch! 🙂 Looking into thetranslation history of this page, 3 out of 4 translations used the English term "fall-through", while only the most recent one replaced it with the German words "Durchfall" and "Durchfallen". While this translation is not necessarily incorrect, it highlights a trade-off: leaving a term untranslated (e.g., "fall-through") vs. using a German equivalent that, while technically accurate, might feel unconventional or humorous to some readers. I have re-translated the page with our latest prompt, which now uses "fall-through" again:mdn/translated-content-de@b58ce94 @yatil Could you confirm whether "fall-through" should remain untranslated? If a German translation is preferred, do you have a suggestion for an alternative that might work better? Based on your input, we can update our translation glossary to ensure consistent handling of this term moving forward.
@AliveDevil MDN is committed to transparency in its approach to machine translation, and we encourage the Community to participate in refining the German translation. We believe that collaboration and feedback from both beginners and experienced developers will significantly improve translation quality over time. To support this, we’re actively seeking input through multiple channels, such as the "MDN-Feedback-Box" at the bottom of every translated page, discussions like this one, and the#german channel on Discord. Please continue to share any terminology issues you spot, along with your suggestions for improvements. 🙏 Your feedback is invaluable to us. PS: We kindly ask everyone to follow theMozilla Community Participation Guidelines to ensure a constructive and respectful collaboration. Let’s stay direct, but also positive and solution-oriented. 😊 |
BetaWas this translation helpful?Give feedback.
All reactions
-
I will not help support machine-translated resources, so I cannot reply to your question, even if I knew the answer. |
BetaWas this translation helpful?Give feedback.
All reactions
❤️ 12
-
It is. "Ausnutzen des Durchfalls" is not the correct translation. "Taking advantage of fall-through" is translated with "Taking advantage of diarrhea" in this post. "Ausnutzen des Durchfallens" would be technically correct. Even if it's a completely weird way to write. You want to know what shouldn't be translated automatically from your AI? Everything. Hire translators or keep it in English. Please this does more harm for everyone involved that it helps anyone. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 3
-
The re-translation of the switch page is now live, see:Ausnutzen des Fall-through-Verhaltens. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 2
-
Yes, this should remain as is."Ausnutzen des Fall-through"-Verhaltens" is how I would translate it. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 1
-
Thank you. I double-checked, and this is the only page that uses this term, and the current translation now consistently uses the term "Fall-through". |
BetaWas this translation helpful?Give feedback.
All reactions
❤️ 1
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
Pls just dont..... It's teribble. Make it an Option for people who need it but not the default pls.... Another part to consider... Do you really want to particapte in the llm hype and contribute an not insignificant energy need on a pet project like a german translation... . They need to build new power plants for this bs and you Support that? |
BetaWas this translation helpful?Give feedback.
All reactions
👍 5
-
@philo1989 Thank you for your feedback. I invite you to try out the experimentalRemember language feature that allows you to set your preferred language, and ensures that you will always be redirected there if the current page exists in that language. |
BetaWas this translation helpful?Give feedback.
All reactions
-
Why not adhere to the standard The automatic translations pratically always contain nonsense and are counterproductive, especially on tech topics. It's annoying to turn off this stuff on increasingly many sites (Microsoft, Google, ...). If I would need a translation I would ask the browser to translate the page with the inbuilt translator. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 8
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
I second what@jampy posted: I configured the user settings of my browser to use 1. German 2. English and this is not meant as a request to feed me machine translations. Yes, I see that you provide an opt-out, but you got it wrong, it shouldn't be opt-out, it should be opt-in if anything.
To activate it for all users by default is not only annoying, it is patronizing. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 6
-
Why is an experimental feature forced onto users instead of opt-in? And even your survey doesn't seem really conclusive. I really don't get on what basis this feature is considered useful. I hate these localization, as they make my life harder to simply read some documentation, just because I'm a non-native English speaker. English is a mandatory subject in German school system, everyone needs to acquire English skills. So if your target audience for MDN is German children under 14 than this feature may be useful, but elsewise it is not. It makes life harder as these translations are always not quite right. There may be figures that not fit the text, even variables that may be cross referenced inside the documentation text. And sometimes translated terminology is simply harder to understand. If you want to find more information it's alot harder as these translations are never consistent and even if they would be consistent there would be alot more English content out there. In the "best case" it would lead to more content tailored to a specific language, but this would result in less helpful results on Google or any other search engine, as every language would use their own terminology or phrasing. Cross referencing English and translated documentation is really hard even if you are quite familiar with English and German terminology. Cross referencing is alot harder than consistently using English for docs. Instead of this translation effort you could consider finding passages that are hard to understand for non-native speakers and improve these sections or try to use some language processing to find words or phrases that are uncommon and as such less known by non-native speakers. You may even try LLMs to find sections that might be hard to understand or even establish a workflow that require easy readability before something is added to the docs. But this AI-translation are not a good solution and even docs on Google or Microsoft that had these kind of translation for quite some time still fail to deliver quality results. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 9
-
Also, I'm having a hard time figuring out how to switch to the original version. There is a link to this issue here, but no "switch to original". |
BetaWas this translation helpful?Give feedback.
All reactions
-
@jampy You can switch to the original version by selecting "English (US)" in the language switcher on the top right: You can enable "Remember language" to always be redirected to that language, even if clicking on a |
BetaWas this translation helpful?Give feedback.
All reactions
-
@caugner thanks, but it's not really easy to find in the mobile version (it's hidden in one of three menus). Since there is already a banner for the translation experiment visible, a direct command would be useful. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 1
-
I had also a hard time finding the language option on mobile. Please don't do this by default. At least put an "Switch to original" prominently in the info box. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 1
-
Thank you for this effort. I personally will not use this myself, but this will certainly be immensely helpful to a lot of German-speaking people. Please don't be let down by the criticism, I think machine translation is a revolutionary tool that enables the world to be understood by more people, and with LLMs, it has come so far that it can reliably translate large structured documents like those found on the MDN docs. Obviously, mistakes will still happen but that's what the feedback function is for. |
BetaWas this translation helpful?Give feedback.
All reactions
👎 9❤️ 5
-
Please don't make assumptions on what would be good for other people if you are not part of that group. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 10
-
I am part of the german speaking group, and i can say i find it incredibly annoying. I have been hit with autotranslated content also on the microsoft c# docs page for instance, and on reddit, and it is incredibly frustrating. basically before i can interact with the content i have to turn it off, because i absolutelywant reliable information. Information that has a traceable source. Translations are never as accurate as the original, and this really matters in many cases of programming (think about security, reliability, data integrity, etc. - this is stuff i really do not want to jeopardise). I have seen that there appears to be a way of having the site remember my choice, though i really think this translation feature does not bring any real benefit whatsoever. Please donot participate in this trend, MDN. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 9
-
@wparad I too am a native German speaker and English is only my second language - and I too prefer text in its original version and switch all documentation I read to English. But surely, for people who are not yet well-versed in the English language, 95% accurate translations should be helpful and lower the barrier of entry for them - even if the translations feel a little awkward and stiff at times. The German option is also completely additional to the rest of MDN and there is no obligation to use it. What I do understand can be annoying, and I would be annoyed by this myself, is if websites would constantly autoswitch to German based on my location or something and ignore my preference. I have all my locales set to English, so this doesn't really happen for me anymore, but I can't speak on how MDN behaves regarding this matter. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 1
-
@Vanilagy but these are developer docs not user facing help sites, and most German speaking developers I know prefer the original English version. That's why I think here it should be the other way round: displaying a banner that say's that the docs are also available in (auto translated) German. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 3
-
@kleinph Yeah of course, I think that makes sense. This feature shouldn't be an annoyance to the German devs who always go for the English docs. I just found that there's this toggle here: It seems like this was explicitly added to address the issue that people want a fixed language, but their search engine might return localized results first. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 2
-
Some external links seem to be encapsulated with parenthesis in the auto translated version which completely breaks them: Seehttps://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API/Using_Service_Workers#demo On that page the link behindsimple service worker running live is changed: This is a relative path that links to This should not happen with software that only translates strings. Please switch this off. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 1
-
Thanks for the report, this is now fixed viamdn/translated-content-de@815643e. PS: I checked, and this was the only occurrence of this issue. If this happens again, we will consider refining the translation automation. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 1
This comment was marked as spam.
This comment was marked as spam.
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
I appreciate the effort to make MDN more accessible. Unfortunately, as a developer with German as my native language, I see this change as a significant regression. Your own survey results show that the majority prefers English, which makes sense given the high English proficiency among German-speaking developers. But even for the other group, I'm sure that they're not particularly pleased with the low quality of the articles on MDN now. Most of the translated content isn'ttechnically incorrect (save for "Durchfall" which was absolutely incorrect, there's no denying it). But LLMs tend to create such a jungle of words that doesn't just sound weird, but is significantly more difficult to comprehend! This is especially true for technical jargon, which users effectively have to translate back to English to understand. The current implementation feels like a solution looking for a problem. This is especially true for users who haveboth (In case you're wondering, setting So, please, Mozilla, stop forcing your US-centric world view upon us. Many users strongly dislike orhave a hard time reading technical documentation in any language other than English because it is the standard language in software development! I wouldn't even want a human-translated version, but shoving machine-translated content in my face is quite frankly insulting. I commend your effort to improve accessibility for one group, but only as long as it doesn't negatively impact the other in a big way. (The other group being larger by the way, according to your own survey). Please consider implementing one or both of the following solutions:
Option 2) would serve both groups better byrespecting user preferences. Thank you for considering this feedback. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 11
-
This! So much This! Thank you for articulating what I strongly feel myself but lack the patience and emotional self-command to type up; coherently, eloquent, clear, while staying polite. |
BetaWas this translation helpful?Give feedback.
All reactions
-
Thank you for taking the time to provide your feedback. 🙌
If you come across technically inaccurate content, please alwaysreport issues with the German content here. 🙏 For the record, as of May 2025, no systematic errors with the German locale have been reported, and the feedback received so far via the article footer is mostly positive.
To clarify: MDN uses the Please note that this behavior has not changed. If you think this is wrong, I encourage you toopen a new frontend issue here.
I get your strong opinion, and frustration, but I still believe that it's fair for users to activate the "Remember language" function once if they prefer the English version. If you have suggestions to make this feature easier to enable or discover, pleaseopen a new frontend issue here. PS: We're aware of limited discoverability of the feature on mobile (seethis thread below). |
BetaWas this translation helpful?Give feedback.
All reactions
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
BetaWas this translation helpful?Give feedback.
All reactions
🎉 1
-
Thanks for flagging! We're aware of this issue, and it will be fixed in our new front-end that we're currently working on. |
BetaWas this translation helpful?Give feedback.
All reactions
This comment was marked as spam.
This comment was marked as spam.
This comment was marked as spam.
This comment was marked as spam.
This comment was marked as spam.
This comment was marked as spam.
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
Is there a way to disable forced translations completely, one for all? I am German and speak multiole languages . So I am also not interested at all in that f*cking "Remember language". Please just get rid of that translation thing. Edit: Thinking about this, I think I would like very much an option "[Always] Show article in original language". This would be the best to avoid translation bugs. Edit 2: Maybe a better target group for the translation feature would be the Hispanics, whose language proficiency is commonly poor; for example in South and Middle America the part of the Latino populace who speak a second language other than Spanish/Portuguese is in the low 1-digit percentage. Edit 3: With a HTTP_ACCEPT_LANGUAGE = 'en-US,en;q=0.5' this forced translation into German can only be caused by IP geolocation. So this is another point that warrants an option "never translate", if one is travelling. In any case, what is hyper-annoying is that MDN does not keep the language setting, so one has to switch to English manually EVERY TIME one loads a MDN page. And it is the latter what makes me so pissed off. |
BetaWas this translation helpful?Give feedback.
All reactions
🎉 1🚀 1
-
Who could've known that German translations could evoke such rage in people 😅 I think "Remember language" is literally the "Never again pester me by forcing translations over the original, just show the unadulterated document" button you're looking for, by the way. I also generally recommend changing your browser's locale to English if you mostly browse English content, that way you can avoid this stuff entirely. It's what I did despite being German. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 1
-
@Vanilagy good idea, until you find German websites that enforce English machine translation on you. Sadly those pages are most of the time not run by experienced web-loving people, in hard contrast to the situation we see with mdn. |
BetaWas this translation helpful?Give feedback.
All reactions
-
@kernschmelze Could you provide exact steps to reproduce? With that If you want to be redirected to another locale regardless of what locale you specify, then you should consider using theRemember language feature (seethis announcement for details). |
BetaWas this translation helpful?Give feedback.
All reactions
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
Wait? I can’t disable those bad translations? 2/3 or the German speaking users (mentioned in pr-description) would prefer English, but you’re forcing incorrect machine translated content? Edit: it can be changed, within the „…“ menu. I would very much prefer a „don’t do it“-button within the experiment banner. |
BetaWas this translation helpful?Give feedback.
All reactions
-
Hi@salzig, I'm the Community Manager at MDN, and I need to step in here to remind you of ourCommunity Participation Guidelines. Using hostile or offensive language is not acceptable in our spaces. If this continues, we may need to take further action. We absolutely value your feedback on the German translation experiment. We appreciate the actual feedback here, and please keep sharing these kinds of insights to help us improve the experience for everyone. Let’s keep the discussion respectful. To answer your question, you can find a dialog box on top right of any reference page where you can also store your preference to use English by default. Hope this helps. |
BetaWas this translation helpful?Give feedback.
All reactions
-
Nicely handled,@pransh15. I think it's time for me to unsubscribe from this thread. 80% of the comments are "Omg these translations suck, why can't I disable them permanently"... when you clearly can disable them permanently. Don't see why people need to rant when the switch to use English for the rest of their lives is 5 seconds away. |
BetaWas this translation helpful?Give feedback.
All reactions
👍 1👎 1🎉 1
-
Update:MDN has a new front end! 🎉 To address some of the feedback in this discussion, you can now switch from a translated page to the English original with just a single click, either temporarily ("View in English") or permanently ("Always switch to English"): ![]() |
BetaWas this translation helpful?Give feedback.
All reactions
🎉 2
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
-
I like the option to have a machine translation as a fallback, but in my daily work the fact that the MDN (along with many other websites)default to a machine translation is a significant point of friction. I have set my language headers to signal both english and german as acceptable languages. I would prefer if the MDN respected my user agent settings and served me whatever human written text is available among my preferred languages. Machine translation of technical documentation often has significant quality issues. The browser I have at work is configured (via group policy) in a way that makes the "Always switch to English" option less useful, as that data is lost after a browser restart. Meaning I have to disable the machine translation daily. Edit: It should also be mentioned that Geo-Location is a poor indicator of language preference in general. There are a lot of countries with more than one commonly spoken language (Cameroon, Belgium, India, Canada, ...) and people travel. A UK developer visiting Switzerland may be a little confused as to why they are suddenly shown the MDN in German (or Italian, I suppose), for example. |
BetaWas this translation helpful?Give feedback.






