openstack
/
i18n
Code Issues Proposed changes

Improve translation message docs 

Document the current perecentages for message translation and the
policies used.

For background on the numbers, see
https://bugs.launchpad.net/horizon/+bug/1317794.

Change-Id: I796f71c73976c5acf42f8da92e87207bed1775b2
This commit is contained in:
Andreas Jaeger 2016-10-09 10:58:38 +02:00
parent 246bbecde8
commit 20ebda07d0
1 changed files with 16 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
doc/source/infra.rst
View File

@ -21,15 +21,22 @@ translation results need to be pushed to the corresponding repositories.
To find updates for both Zanata and OpenStack project repositories,
Jenkins starts to run scripts everyday at **6:00 UTC**.
Note that not all translation changes are the target for translation jobs.
Currently, we define that the jobs only download new files that are at least
**75 percent** translated and if files grow over time but do not get new
translations (or strings change too much), they will be removed again from the
project with a threshold of **20 percent**. For the glossary
(openstack-manuals/doc/glossary) and common (openstack-manuals/doc/common)
directories, the download limit is **8 percent** because these documents are
large and only a part is used. The purpose of thresholds is to reduce the
amount of patches that go into a project.
Note that not all translation changes are the target for translation
jobs. The goal is to have consistent translated programs, UIs, and
documentation. There's not much sense if only a few lines are
translated. The team has decided that files that have at least 75
percent of messages translated will be in the git repositories.
To not have too much churn and last minute string fixes lead to files
get removed, there is also a lower threshold for releases of **66
percent** of messages translated as policy - which is only manually
enforced.
The OpenStack infra scripts currently download new files that are at
least **75 percent** translated and if files grow over time but do not
get new translations (or strings change too much), they will be
removed again automatically from the project with a lower threshold of
currently **40 percent**.
Monitoring translation jobs status
----------------------------------