From Fedora Project Wiki

fp-wiki>ImportUser
(Imported from MoinMoin)
 
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
= String and Translation Freezes =
= String Freeze and Translation Deadline =


On both the [[Releases/Schedule| Release Schedule]]  and the [[DocsProject/Schedule| Documentation Schedule]] , there are two dates that affect translations the most: the "string freeze" and the "translation freeze".
On both the [[Releases/Schedule| Release Schedule]]  and the [[DocsProject/Schedule| Documentation Schedule]] , there are two dates that affect translations the most: the "string freeze" and the "translation deadline" (used to be called 'translation freeze' but the term 'deadline' is more appropriate).


Here are some clarifications about them.
Here are some clarifications about them.


{{Anchor|string}}
{{Anchor|string}}
Line 15: Line 13:
The string freeze is there so that translators have a time to do their work, when they do no longer need to chase a moving target. It takes place in preparation for the release, so that we all will be able to be proud of having lots of complete and spiffy translations when the final release happens.
The string freeze is there so that translators have a time to do their work, when they do no longer need to chase a moving target. It takes place in preparation for the release, so that we all will be able to be proud of having lots of complete and spiffy translations when the final release happens.


=== What changes are affected by the string freeze? ===
=== FAQ ===
==== What changes are affected by the string freeze? ====


Fedora string freezes affect the packages that Fedora is upstream for which are included in a release. These includes software (eg. <code>anaconda</code>, <code>firstboot</code>, <code>system-config-*</code>, etc) and [[DocsProject| Documentation]]  (eg. <code>release notes</code>, <code>homepage</code>, etc). A list of modules that interest the [[http| //translate.fedoraproject.org/:FLP]can be found at http://translate.fedoraproject.org/module/.
Fedora string freezes affect the packages that Fedora is upstream for which are included in a release. These includes software (eg. <code>anaconda</code>, <code>firstboot</code>, <code>system-config-*</code>, etc) and [[DocsProject| Documentation]]  (eg. <code>release notes</code>, <code>readme-burning-isos</code>, etc). A list of modules that interest the [http://translate.fedoraproject.org FLP] can be found at [http://translate.fedoraproject.org/projects].


Any addition or change of a string marked for translation (either by <code>gettext</code> or by <code>intltool</code>) in one of these modules is affected by the freeze, apart from the exceptions listed below, and will need announcement and subsequent approval. This is true even for bug fixes that change or alter translatable strings.
Any addition or change of a string marked for translation (either by <code>gettext</code> or by <code>intltool</code>) in one of these modules is affected by the freeze, apart from the exceptions listed below, and will need announcement and subsequent approval. This is true even for bug fixes that change or alter translatable strings.


 
==== What changes are not affected by the string freeze? ====
=== What changes are not affected by the string freeze? ===


* Change or addition of a message that is not marked for translation.
* Change or addition of a message that is not marked for translation.
Line 35: Line 33:
* If you change the <code>GETTEXT_PACKAGE</code> line in your <code>configure.in</code> (then we need to update the translation status pages).
* If you change the <code>GETTEXT_PACKAGE</code> line in your <code>configure.in</code> (then we need to update the translation status pages).


{{ Template:message/notice | If in doubt, please ask in fedora-trans-list@redhat.com.  
{{Admon/tip | If in doubt, please ask in trans@lists.fedoraproject.org.}}
}}
 


=== What should I do before the string freeze starts? ===
==== What should I do before the string freeze starts? ====


* First of all, make sure that your resource (application or documentation) is complete as far as translatable strings are concerned.
* First of all, make sure that your resource (application or documentation) is complete as far as translatable strings are concerned.
Line 45: Line 41:
* Make sure that your module's <code>po/POTFILES.in</code> and <code>po/POTFILES.skip</code> (or any other way you use to choose your translatable files) are correct and up2date and that no source files are lacking from them. Use the command <code>intltool-update --maintain</code> in the po directory to verify.
* Make sure that your module's <code>po/POTFILES.in</code> and <code>po/POTFILES.skip</code> (or any other way you use to choose your translatable files) are correct and up2date and that no source files are lacking from them. Use the command <code>intltool-update --maintain</code> in the po directory to verify.


{{Template:Tip}} It's important that maintainers try to do this -- some translators sometimes try to help out with this, but often it's only the maintainers who have the proper knowledge of what source files are actually used by the application and which aren't.
{{Admon/tip | It's important that maintainers try to do this -- some translators sometimes try to help out with this, but often it's only the maintainers who have the proper knowledge of what source files are actually used by the application and which aren't.}}


* Try to resolve as many bugs with the keyword "string" in Bugzilla as you can. The string freeze is not intended to be a "string fixing period" -- please do such work before the string freeze, since that facilitates the work for everyone.
* Try to resolve as many bugs with the keyword "string" in Bugzilla as you can. The string freeze is not intended to be a "string fixing period" -- please do such work before the string freeze, since that facilitates the work for everyone.
Line 51: Line 47:
We aren't usually as strict when approving freeze breaks at the very beginning of the freeze, as when the freeze has been there for some time. But please don't abuse this.
We aren't usually as strict when approving freeze breaks at the very beginning of the freeze, as when the freeze has been there for some time. But please don't abuse this.


 
==== What should I do in case I want to break the string freeze? ====
=== What should I do in case I want to break the string freeze? ===
 
See the [[ReleaseEngineering/StringFreezePolicy| String freeze policy]]  of the [[ReleaseEngineering| Release Engineering team]] .
See the [[ReleaseEngineering/StringFreezePolicy| String freeze policy]]  of the [[ReleaseEngineering| Release Engineering team]] .


==== What happens if I break the string freeze without approval? ====
You risk the danger of being caught by riots of angry, frustrated translators throwing rotten fish, and risk being publicly humiliated on this mailing list. You have been warned!


=== What happens if I break the string freeze without approval? ===
=== String freeze break history ===
 
You risk the danger of being caught by riots of angry, frustrated translators throwing rotten fish, and risk being publicly humiliated on this mailing list. You have been warned!


{|
! colspan="3" | Fedora 8
|-
| initscripts || [http://www.redhat.com/archives/fedora-trans-list/2007-September/msg00010.html Bill Nottingham] || Approved
|-
| pirut || [http://www.redhat.com/archives/fedora-trans-list/2007-August/msg00120.html Jeremy Katz] || Approved
|-
| system-config-samba || [http://www.redhat.com/archives/fedora-trans-list/2007-August/msg00109.html Nils Philippsen] || Approved
|-
! colspan="3" | Fedora 9
|-
| system-config-users || [http://www.redhat.com/archives/fedora-trans-list/2008-March/msg00182.html Nils Philippsen] || Approved
|-
| anaconda || [http://www.redhat.com/archives/fedora-trans-list/2008-March/msg00161.html Jeremy Katz] || Approved
|-
| release-notes || [http://www.redhat.com/archives/fedora-trans-list/2008-April/msg00103.html Paul Frields] || Approved
|-
! colspan="3" | Fedora 10
|-
| comps || [http://www.redhat.com/archives/fedora-trans-list/2008-October/msg00107.html Christoph Wickert] || Approved
|-
| anaconda || [http://www.redhat.com/archives/fedora-trans-list/2008-October/msg00113.html Chris Lumens] || Approved
|-
| comps || [http://www.redhat.com/archives/fedora-trans-list/2008-September/msg00053.html Bill Nottingham] || Approved
|-
! colspan="3" | Fedora 11
|-
| system-config-printer || [http://www.redhat.com/archives/fedora-trans-list/2009-March/msg00081.html Tim Waugh] || Approved
|-
| initscripts || [http://www.redhat.com/archives/fedora-trans-list/2009-August/msg00091.html Bill Nottingham] || Approved
|-
| comps || [http://www.redhat.com/archives/fedora-trans-list/2009-August/msg00109.html Peter Robinson] || Approved
|-
| desktop-effects || [http://www.redhat.com/archives/fedora-trans-list/2009-August/msg00123.html Owen Taylor] || Approved
|}


{{Anchor|translation}}
{{Anchor|translation}}
{{Anchor|translation_freeze}}
{{Anchor|translation_freeze}}
== Translation freeze ==
{{Anchor|translation_deadline}}
 
== Translation Deadline ==


Translations contributed until the translation freeze are '''guaranteed''' to get in the release. Translations after this '''may or may not''' make it in the release.
Translations contributed until the translation deadline are '''guaranteed''' to get in the release. Translations after this '''may or may not''' make it in the release.


=== How does it affect me as a maintainer? ===
=== How does it affect me as a maintainer? ===
Line 76: Line 107:
=== How does it affect me as a translator? ===
=== How does it affect me as a translator? ===


* Make sure that all your important strings get committed before the translation freeze.
* Make sure that all your important strings get committed before the translation deadline.
* Translations may continue after it (so technically it's not really a freeze), but they are not guaranteed to make it in the release.
* Translations may continue after it (so technically it's not really a deadline), but they are not guaranteed to make it in the release.
* Keep an eye on the packages and make sure that your contributions up to the translation freeze date were included in the release. If not, notify the list.
* Keep an eye on the packages and make sure that your contributions up to the translation deadline date were included in the release. If not, notify the list.
 


== References ==
== References ==
* [http://live.gnome.org/TranslationProject/HandlingStringFreezes HandlingStringFreezes page from live.gnome.org] .
* [http://live.gnome.org/TranslationProject/HandlingStringFreezes HandlingStringFreezes page from live.gnome.org] .


----
[[Category:Localization]]
[[Category:Localization]]

Latest revision as of 12:14, 19 February 2010

String Freeze and Translation Deadline

On both the Release Schedule and the Documentation Schedule , there are two dates that affect translations the most: the "string freeze" and the "translation deadline" (used to be called 'translation freeze' but the term 'deadline' is more appropriate).

Here are some clarifications about them.

String freeze

A string freeze is a date when translatable strings and user-interfaces are frozen. No new strings can be added or existing ones modified from this date to the release, as noted on the Release String freeze policy .

The string freeze is there so that translators have a time to do their work, when they do no longer need to chase a moving target. It takes place in preparation for the release, so that we all will be able to be proud of having lots of complete and spiffy translations when the final release happens.

FAQ

What changes are affected by the string freeze?

Fedora string freezes affect the packages that Fedora is upstream for which are included in a release. These includes software (eg. anaconda, firstboot, system-config-*, etc) and Documentation (eg. release notes, readme-burning-isos, etc). A list of modules that interest the FLP can be found at [1].

Any addition or change of a string marked for translation (either by gettext or by intltool) in one of these modules is affected by the freeze, apart from the exceptions listed below, and will need announcement and subsequent approval. This is true even for bug fixes that change or alter translatable strings.

What changes are not affected by the string freeze?

  • Change or addition of a message that is not marked for translation.
  • Removal of a translatable string.
  • Addition of a comment aimed for translators.
  • Addition of a translatable message (or change a translatable message into a message) that is absolutely identical to an existing message that is already marked for translation, and that has the same meaning and context. Then the existing translation will automatically be re-used.

The following types of changes do not need explicit approval, however we would still very much like them to be announced so that we know about them:

  • Marking a message for translation that was previously not marked for translation by accident.
  • Adding a file to POTFILES.in that was previously not included in POTFILES.in by accident.
  • If you change the GETTEXT_PACKAGE line in your configure.in (then we need to update the translation status pages).
If in doubt, please ask in trans@lists.fedoraproject.org.

What should I do before the string freeze starts?

  • First of all, make sure that your resource (application or documentation) is complete as far as translatable strings are concerned.
  • Make sure that your module's po/POTFILES.in and po/POTFILES.skip (or any other way you use to choose your translatable files) are correct and up2date and that no source files are lacking from them. Use the command intltool-update --maintain in the po directory to verify.
It's important that maintainers try to do this -- some translators sometimes try to help out with this, but often it's only the maintainers who have the proper knowledge of what source files are actually used by the application and which aren't.
  • Try to resolve as many bugs with the keyword "string" in Bugzilla as you can. The string freeze is not intended to be a "string fixing period" -- please do such work before the string freeze, since that facilitates the work for everyone.

We aren't usually as strict when approving freeze breaks at the very beginning of the freeze, as when the freeze has been there for some time. But please don't abuse this.

What should I do in case I want to break the string freeze?

See the String freeze policy of the Release Engineering team .

What happens if I break the string freeze without approval?

You risk the danger of being caught by riots of angry, frustrated translators throwing rotten fish, and risk being publicly humiliated on this mailing list. You have been warned!

String freeze break history

Fedora 8
initscripts Bill Nottingham Approved
pirut Jeremy Katz Approved
system-config-samba Nils Philippsen Approved
Fedora 9
system-config-users Nils Philippsen Approved
anaconda Jeremy Katz Approved
release-notes Paul Frields Approved
Fedora 10
comps Christoph Wickert Approved
anaconda Chris Lumens Approved
comps Bill Nottingham Approved
Fedora 11
system-config-printer Tim Waugh Approved
initscripts Bill Nottingham Approved
comps Peter Robinson Approved
desktop-effects Owen Taylor Approved

Translation Deadline

Translations contributed until the translation deadline are guaranteed to get in the release. Translations after this may or may not make it in the release.

How does it affect me as a maintainer?

  • Your package shipped in the final release must contain the translations contributed until this date. Repackage if necessary.
  • If no translations have been contributed since your last packaging, there is no need to repackage.
  • The later the repackaging takes place, the more translations will potentially make it in the release. Translators of popular packages (like anaconda) appreciate having an up2date package before test3 to test it and make corrections.

How does it affect me as a translator?

  • Make sure that all your important strings get committed before the translation deadline.
  • Translations may continue after it (so technically it's not really a deadline), but they are not guaranteed to make it in the release.
  • Keep an eye on the packages and make sure that your contributions up to the translation deadline date were included in the release. If not, notify the list.

References