As Monica Rush wrote in the "About: Wiki Localization" article, a plan
for non-English versions of the Wiki and/or non-English version of individual wiki articles is being created: every Wiki contributor is encouraged to provide translations for his/her articles in his/her mother tongue or to write in article into any language
he/she is able to speak and write in.
↑ Return to top
This document (that will be improved and updated every time a new rule will be established or a new suggestion will be accepted) is just a collection of simple guidelines that the contributors are encouraged to follow to make the Wiki Community most useful
even for non-English readers and authors and to give a common format to the articles in such a way that writing and searching a localized article will always be easy.
If you decide to translate an existing article into a different language, the first action (that can speed up your translation work) you can perform is running a Bing translation of the article's
text or using the Microsoft Translator Widget (well documented in
Bruno Lewin's article "Microsoft Translator Widget and Wiki"): this widget (illustrated in Figure 1) appears as a small control,
on the right of each Wiki page, that allows you to translate the page on the fly into your preferred language; of course, this is only a first draft (something like a "beta" version of the final translation), that have to be read again, verified and edited
when necessary before posting into the Wiki. Software are gettin' smarter and smarter, but a final human revision is still indispensable!
Figure 1: The Microsoft Translator Widget.
Finding the right term in your language is not always easy, but there is help. You can access Microsoft terminology in many languages from the
Microsoft Language Portal, including a quick lookup of specific terms (http://www.microsoft.com/Language/en-US/Search.aspx)
Figure 2: The Microsoft Language Portal.
Other companies also make their technical terminology available
The title of the article and the list of tags should reflect the language the article is written in: this will be accomplished by
adding the string representing the language code both at the end of the article's title (enclosed in round brackets) and in the tags list. For example, an article written in Italian will be titled "Article title (it-IT)" and the tags list will
include the "it-IT" string. This is done for two reasons. (1) This will help the users of the Community to quickly find articles by performing a search based on the language the article could be written in (or click the tag to see all the article on TechNet
Wiki in that particular language). (2) When we create an instance/version of TechNet Wiki devoted to that language, we'll want to migrate all the articles in that language. This tagging system makes that possible.
You can find the codes for all the languages (as well as links to all the articles in each language) at the "Non-English Language Title Guidelines" page.
It is also recommended adding the “Multi Language Wiki Articles” tag to identify articles written and/or translated in multiple languages; each translated article should also include the
"Translated into (language)" tag, where "(language)" must be replaced with the language the article is translated into (e.g.: "Translated into Italian" will be added to the tags list to indicate that the article is the Italian
translation of another article): you can find a list of the currently used translation tags in the "Wiki: Translation Tags" page.
After that, you have to make the Wiki know that a new localized article exists and has been published. At this moment, this can be accomplished in one (or both) of the two following ways:
This option works best when various contributors will add languages over time. Contributors will be able to more easily see what languages are missing and decide to add one or more. A drawback is that the list exists in each language version of the article
so multiple copies may need maintenance!
This option avoids having maintain multiple copies of the list of links to other languages in every article, but it's critical to put a link to this list in the article, so it can be found. We have mostly used it as part of planned efforts to publish an
article in many languages.
As mentioned before, this is only the first release of the "translation rules" for non-English content articles: comment this page to provide your feedbacks and suggestions.
Have a good translation!