summaryrefslogtreecommitdiff
path: root/po
diff options
context:
space:
mode:
authorLibravatar Bagas Sanjaya <bagasdotme@gmail.com>2021-03-11 18:36:57 +0700
committerLibravatar Jiang Xin <worldhello.net@gmail.com>2021-06-02 11:21:26 +0800
commit69c13a7880d1682efed0b557c7cbcadbf630eb45 (patch)
tree704be55a09ec80dfcbadb4c3d490f86a5f197f41 /po
parentl10n: README: document "core translation" (diff)
downloadtgif-69c13a7880d1682efed0b557c7cbcadbf630eb45.tar.xz
l10n: README: document l10n conventions
Document the conventions that l10n contributors must follow. Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com> Signed-off-by: Jiang Xin <worldhello.net@gmail.com>
Diffstat (limited to 'po')
-rw-r--r--po/README.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/po/README.md b/po/README.md
index d85b5fa723..f6f376eedf 100644
--- a/po/README.md
+++ b/po/README.md
@@ -340,4 +340,50 @@ Usage for git-po-helper:
Run "git-po-helper" without arguments to show usage.
+
+Conventions
+-----------
+
+There are some conventions that l10n contributors must follow:
+
+1. The subject of each l10n commit should be prefixed with "l10n: ".
+2. Do not use non-ASCII characters in the subject of a commit.
+3. The length of commit subject (first line of the commit log) should
+ be less than 50 characters, and the length of other lines of the
+ commit log should be no more than 72 characters.
+4. Add "Signed-off-by" trailer to your commit log, like other commits
+ in Git. You can automatically add the trailer by committing with
+ the following command:
+
+ git commit -s
+
+5. Check syntax with "msgfmt" or the following command before creating
+ your commit:
+
+ git-po-helper check-po <XX.po>
+
+6. Squash trivial commits to make history clear.
+7. DO NOT edit files outside "po/" directory.
+8. Other subsystems ("git-gui", "gitk", and Git itself) have their
+ own workflow. See [Documentation/SubmittingPatches][] for
+ instructions on how to contribute patches to these subsystems.
+
+To contribute for a new l10n language, contributor should follow
+additional conventions:
+
+1. Initialize proper filename of the "XX.po" file conforming to
+ iso-639 and iso-3166.
+2. Must complete a minimal translation based on the "po-core/core.pot"
+ template. Using the following command to initialize the minimal
+ "po-core/XX.po" file:
+
+ git-po-helper init --core <your-language>
+
+3. Add a new entry in the "po/TEAMS" file with proper format, and check
+ the syntax of "po/TEAMS" by runnning the following command:
+
+ git-po-helper team --check
+
+
[git-po-helper/README]: https://github.com/git-l10n/git-po-helper#readme
+[Documentation/SubmittingPatches]: Documentation/SubmittingPatches