summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBob Van Landuyt <bob@gitlab.com>2017-06-09 13:24:13 +0200
committerBob Van Landuyt <bob@gitlab.com>2017-06-09 13:24:13 +0200
commit42d697368803dee183d968377f3cf1923d86c630 (patch)
tree6d41b90e99480b882a6c410144c77ccdf802eb33
parent9999704ae0d2b7cab2e8a767096c62149c5cc409 (diff)
downloadgitlab-ce-42d697368803dee183d968377f3cf1923d86c630.tar.gz
Mention the cause of missing translations in the docs
-rw-r--r--doc/development/i18n_guide.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/development/i18n_guide.md b/doc/development/i18n_guide.md
index bfb0779fbfa..756535e28bc 100644
--- a/doc/development/i18n_guide.md
+++ b/doc/development/i18n_guide.md
@@ -127,6 +127,14 @@ New translations will be added with their default content and will be marked
fuzzy. To use the translation, look for the `#, fuzzy` mention in `gitlab.edit.po`
and remove it.
+We need to make sure we remove the `fuzzy` translations before generating the
+`locale/**/gitlab.po` file. When they aren't removed, the resulting `.po` will
+be treated as a binary file which could overwrite translations that were merged
+before the new translations.
+
+When we are just preparing a page to be translated, but not actually adding any
+translations. There's no need to generate `.po` files.
+
Translations that aren't used in the source code anymore will be marked with
`~#`; these can be removed to keep our translation files clutter-free.