This article is a basic guide to translating content on MDN, including both the mechanics of translation work and tips on the proper way to handle various types of content.
Starting a new page translation
When you come across a page you'd like to translate into your language, follow these steps:
- Click the Languages icon ( ) to open the Languages menu, and click Add a Translation. The Select Languages page appears.
- Click the language that you want to translate the page into. The Translating Article view opens with the original language text displayed on the left side of the view.
- Under Translate Description, you can translate the title and optionally the slug into the target language. The slug is the last part of the URL of a page (for example, "Translating_pages" for this article.) Some language communities do not translate the slug, keeping the same slug as English. Compare with other articles in your language to determine the common practice. You can click the minus sign next to Translate Description to hide this information when you are done with it, to make more room for the Translate Content section.
- Under Translate Content, translate the body of the page.
- Fill at least one tag for the page
- Click Save Changes when you are done.
Editing a translated page
- On a translated page, click the Edit button (sometimes labeled in the target language). The Translating Article view opens.
If the English version has been changed since the translation was last updated, the Translating Article view shows a source-level "diff" of the changes in the English version. This helps you see what needs to be updated in the translation.
It's important that each page is tagged with at least one tag. Even if this is translation.
Some tags are used for search filters, or as conventions between contributors. They should not be translated. To know these tags, read the tagging standards. You are free to create translated tags to group content if this is not covered by one of the standards tags.