Changes between Version 1 and Version 2 of TranslationsAndStringFreezes

Timestamp:

May 27, 2018, 4:00:05 AM (6 years ago)

Author:

John Bailey

Comment:

Flesh out this page a bit.

TranslationsAndStringFreezes

@@ -1 +1 @@
 = Translations and String Freezes =
-Pidgin is developed primarily by English-speaking people.  We use the United States dialect of English within our source code for text that you as the user see when you use Pidgin.  That's all fine and well for people in the United States, of course, but what about people that speak and read other languages?
+Pidgin is developed primarily by English-speaking people.  We use the United States dialect of English within our source code for text (character strings, or strings for short) that you as the user see when you use Pidgin.  That's all fine and well for people in the United States, of course, but what about people that speak and read other languages?  Well, Pidgin has translation support, known as either "internationalization" (i18n) or "localization" (l10n).  This allows us to put English strings in the source code but still have the correct text displayed for another language, whether it be a different dialect of English, a dialect of Spanish, or even Mandarin Chinese.
+
+== How Does It Work? ==
+Within our source code and interface designs, we have strings that are displayed to the user.  They can be anything from "Manage Accounts" to "Extended Away" to "Quit".  These user-visible strings are "marked" for translation.  That is to say that we mark within the source code and interface designs that the given text should be translated.  Using the appropriate tools with the gettext library, a translation template, known as a "pot" file, is generated.  Someone who wishes to translate Pidgin into another language will take the translation template, name it appropriately for the language of his/her choice and review each string in the file, entering the correctly translated text for that language into the file.  Once completed, the translator submits the translation to us.  (See TipsForTranslators for specific details.)  The completed translations are "compiled" into the format needed by gettext at runtime, and the appropriate file is loaded when Pidgin is launched in a given language.  Each time text needs to be displayed, gettext uses the text we specified to determine the correct translated text to display and uses it instead.  (Any text that isn't translated will simply show the English text we originally specified so that Pidgin functions.)
+
+== String Freezes ==
+During the Pidgin development cycle, we'll call for a string freeze close to release.  A string freeze means that no user-visible strings are allowed to be added or changed until the release is made.  This allows the translators time to translate any new strings and revise their existing translations if they feel the need to do so.  The string freeze means that all text specified in the code and designs are final for the release currently being worked on, even if there is a spelling or grammar mistake or some other problem in one or more strings.
+
+Typically a string freeze will last for a week, as there usually aren't many changes that would require existing translators' attention.  Occasionally a longer freeze will be required if there are significant changes--usually two weeks are enough in these cases.  However, huge changes, like Pidgin 3.0.0 will be when we are ready to look at releasing it, will require significantly more time investment from our translators.  A string freeze of a month could be implemented to give translators enough time to update translations appropriately.  Or, alternatively, multiple shorter string freezes could be done throughout the development cycle to reduce the overall burden of maintaining the translations.