Translating Moodle Docs
Contributing to the documentation
Moodle Docs pages, such as the page you are reading right now, are wiki pages available in several languages. Any registered Moodle user can contribute to Moodle Docs and improve or translate these wiki pages. Please make sure to follow the guidelines for contributors.
You might find it useful to add the original English documentation pages that you have just translated to your watchlist (alt-shift-w), so that you will know when your translation might need to be re-checked for a possible update.
Which documentation pages are most important or useful to translate?
Many Moodle users will start reading the English docs main page. This might be a good page to have translated.
The new features in the latest version would surely be of interest to the users of previous Moodle versions that want to catch up with the new available features.
The quick guides are very short pages (that hopefully you can very quickly translate) that teachers can quickly check, in order to grasp how an important Moodle feature works, without having to read the standard detailed (long) Moodle full documentation pages.
The Table of contents has a very comprehensive and organized list of important Moodle topics. This might be a worthy addition to your language documentation.
If you see a post which has been rated as 'Useful' several times in a Forum in a language other than English, which links to an untranslated English documentation page, it might be a good idea to translate this page.
The English Documentation Special Page with the Most linked-to pages shows the English pages that have the highest number of links and (except for all the User: pages) you will find there many pages highly useful for Moodlers of all languages and worth translating to your language (e.g., Managing a Moodle site & Managing a Moodle course).
If you are a Moodle site admin or teacher, using a language other than English, and you use the 'Moodle Docs for this page' link in your daily work, please consider translating the English pages that helped you most to do your job and solve your problems. See below.
Translating the Documentation pages for 'Mooodle Docs for this page' and 'More help' links
- When logged in as an admin or teacher, 'Moodle Docs for this page' links at the bottom of each page in Moodle take you to documentation about that page in your language, if it exists, otherwise in English.
- You might be tempted to start typing the documentation in your own language (if such a page exists), but please don't do it. Instead, change your language to English and then click in the 'Moodle Docs for this page' link.
- In the English documentation page that just opened, add a language link for your language (see Interlanguage-linking), save it and then open the given translation page.
- If the English Documentation page has only a redirect instruction, please add a translation for the redirection and then save the English page with the redirection
- Make sure that you add a translation link for the redirection, check that it works (create the page if it did not exist) and save the page.
- You can now jump to the redirected page in your own language and work on it.
- The 'More help' links have the same icon (i) and work the same way as the 'Moodle Docs for this page' links.
Is it important to translate English Documentation pages that only have one #Redirect instruction?
Yes, it is very, very fast and it will make your translated wiki more efficient, because you will replicate all the automatic redirections that exist in the English Docs in your own language Docs, specially with the Docs pages related to online help for specific pages in your Moodle server (see the example above).
If you have translated Documentation pages with #Redirect instructions, it will then be a good idea to go to the TOOLS column at the bottom of the page (in your language wiki documentation) and click on 'Special pages'. There, check the 'Broken redirects' and 'Double redirects' links and fix any pages that might show up there.
Which English documentation pages will change when there is a new Moodle version release
- If you have a translation of https://docs.moodle.org/dev/Releases you will need to update it
- The new features in the latest version mentioned above must now have the new available features.
- You might need to update the version numbers in your translated documentation for these pages:
See also
- Starting a new docs wiki
- Help strings in the developers documentation