diff options
| author | Julien Lepiller <julien@lepiller.eu> | 2022-03-08 13:14:58 +0100 |
|---|---|---|
| committer | Julien Lepiller <julien@lepiller.eu> | 2022-04-02 18:12:48 +0200 |
| commit | 6386c011b2bb682cfdbcbd4cf8fcc40e94e950b5 (patch) | |
| tree | afe9bdfca604eb3950155e0f60fde7d611498a04 | |
| parent | 49d0a80738a7676f148e42370d7feb0ab8253928 (diff) | |
doc: Document inclusion requirements for new translations.
* doc/contributing.texi (Translating Guix)[Conditions for Inclusion]:
New section.
| -rw-r--r-- | doc/contributing.texi | 22 |
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 | |||
| 1916 | There 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 | ||
| 1918 | string. New languages will be added to Guix as soon as possible. The | ||
| 1919 | files may be removed if they fall out of sync and have no more translated | ||
| 1920 | strings. | ||
| 1921 | |||
| 1922 | Given that the web site is dedicated to new users, we want its translation | ||
| 1923 | to be as complete as possible before we include it in the language menu. | ||
| 1924 | For a new language to be included, it needs to reach at least 80% completion. | ||
| 1925 | When a language is included, it may be removed in the future if it stays | ||
| 1926 | out of sync and falls below 60% completion. | ||
| 1927 | |||
| 1928 | The manual and cookbook are automatically added in the default compilation | ||
| 1929 | target. Everytime we synchronize translations, developers need to | ||
| 1930 | recompile all the translated manuals and cookbooks. This is useless for what | ||
| 1931 | is essentially the English manual or cookbook. Therefore, we will only | ||
| 1932 | include a new language when it reaches 10% completion in the component. | ||
| 1933 | When a language is included, it may be removed in the future if it stays | ||
| 1934 | out of sync and falls below 5% completion. | ||
| 1935 | |||
| 1914 | @subsubheading Translation Infrastructure | 1936 | @subsubheading Translation Infrastructure |
| 1915 | 1937 | ||
| 1916 | Weblate is backed by a git repository from which it discovers new strings to | 1938 | Weblate is backed by a git repository from which it discovers new strings to |
