summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulien Lepiller <julien@lepiller.eu>2022-03-08 13:14:58 +0100
committerJulien Lepiller <julien@lepiller.eu>2022-04-02 18:12:48 +0200
commit6386c011b2bb682cfdbcbd4cf8fcc40e94e950b5 (patch)
treeafe9bdfca604eb3950155e0f60fde7d611498a04 /doc
parent49d0a80738a7676f148e42370d7feb0ab8253928 (diff)
downloadguix-patches-6386c011b2bb682cfdbcbd4cf8fcc40e94e950b5.tar
guix-patches-6386c011b2bb682cfdbcbd4cf8fcc40e94e950b5.tar.gz
doc: Document inclusion requirements for new translations.
* doc/contributing.texi (Translating Guix)[Conditions for Inclusion]: New section.
Diffstat (limited to 'doc')
-rw-r--r--doc/contributing.texi22
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi
index 207efc4ee6..862dcbf12a 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1911,6 +1911,28 @@ Currently, some parts of Guix cannot be translated on Weblate, help wanted!
translated.
@end itemize
+@subsubheading Conditions for Inclusion
+
+There are no conditions for adding new translations of the @code{guix} and
+@code{guix-packages} components, other than they need at least one translated
+string. New languages will be added to Guix as soon as possible. The
+files may be removed if they fall out of sync and have no more translated
+strings.
+
+Given that the web site is dedicated to new users, we want its translation
+to be as complete as possible before we include it in the language menu.
+For a new language to be included, it needs to reach at least 80% completion.
+When a language is included, it may be removed in the future if it stays
+out of sync and falls below 60% completion.
+
+The manual and cookbook are automatically added in the default compilation
+target. Everytime we synchronize translations, developers need to
+recompile all the translated manuals and cookbooks. This is useless for what
+is essentially the English manual or cookbook. Therefore, we will only
+include a new language when it reaches 10% completion in the component.
+When a language is included, it may be removed in the future if it stays
+out of sync and falls below 5% completion.
+
@subsubheading Translation Infrastructure
Weblate is backed by a git repository from which it discovers new strings to