Abstract
Translations must always be a community effort.
Resources in need of translation can be roughly divided into 2 groups. The first one being message strings (single strings), the other one being whole documents (i.e. narrative text). As most resources change with each new version it becomes necessary to update or add new translations with each new version.
Status
The upcoming and current status of translation should be made transparent to all collaborators. This may happen in a public wiki document which gets edited.
Workflow
- Developers are working on a new version in
x-*
branches. - The integrator begins merging in branches into master, declaring string freeze 1 week before release.
- The integrator branches
x-translation
off ofmaster
. - The translation integrator extracts strings and updates existing message catalogs template and updates existing message catalogs.
- The translation integrator assembles dis may happen in a public wiki document which gets edited.
Workflow
- Developers are working on a new version in
x-*
branches. - The integrator begins merging in branches into master, declaring string freeze 1 week before release.
- The integrator branches
x-translation
off ofmaster
. - The translation integrator extracts strings and updates existing message catalogs template and updates existing message catalogs.
- The translation integrator assembles dis may happen in a public wiki document which gets edited.
Workflowona new version in x-*
branches.
- The integrator begins merging in branches into master, declaring ease.
- The translation integrator sends out release blog post as early as possible (most often this is 1 day before release) to translation coordinators.
- The translation coordinators translate and send back blog post as early as possible in order to have all translations ready on release.
- The translation integrator adds the translations to the post as they are coming in (even after the release).
Things In Need of Translation
- lithium_site static messages
- li3_bot static messages
- li3_docs static messages
- lithium generated API documents
- lithium release blog posts
- lithium press releases
- lithium guides
- lithium tutorials
String Freezes
String freezes exists so that translators have time to work on translations without worrying about that the original English strings in the source code change. After such a freeze the following changes must be announced to the translation integrator.
- Modification of a message which is marked for translation release).
Things In Need of Translation
- lithium_site static messages
- li3_bot static messages
- li3_docs stat