summaryrefslogtreecommitdiff
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
parent49d0a80738a7676f148e42370d7feb0ab8253928 (diff)
doc: Document inclusion requirements for new translations.
* doc/contributing.texi (Translating Guix)[Conditions for Inclusion]: New section.
-rw-r--r--doc/contributing.texi22
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi
index 207efc4ee6c..862dcbf12aa 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!
1911 translated. 1911 translated.
1912@end itemize 1912@end itemize
1913 1913
1914@subsubheading Conditions for Inclusion
1915
1916There are no conditions for adding new translations of the @code{guix} and
1917@code{guix-packages} components, other than they need at least one translated
1918string. New languages will be added to Guix as soon as possible. The
1919files may be removed if they fall out of sync and have no more translated
1920strings.
1921
1922Given that the web site is dedicated to new users, we want its translation
1923to be as complete as possible before we include it in the language menu.
1924For a new language to be included, it needs to reach at least 80% completion.
1925When a language is included, it may be removed in the future if it stays
1926out of sync and falls below 60% completion.
1927
1928The manual and cookbook are automatically added in the default compilation
1929target. Everytime we synchronize translations, developers need to
1930recompile all the translated manuals and cookbooks. This is useless for what
1931is essentially the English manual or cookbook. Therefore, we will only
1932include a new language when it reaches 10% completion in the component.
1933When a language is included, it may be removed in the future if it stays
1934out of sync and falls below 5% completion.
1935
1914@subsubheading Translation Infrastructure 1936@subsubheading Translation Infrastructure
1915 1937
1916Weblate is backed by a git repository from which it discovers new strings to 1938Weblate is backed by a git repository from which it discovers new strings to