l10n: document AI and PO helper in po/README

Document po/AGENTS.md-driven AI workflows (with an example prompt)
before the PO helper section, cross-reference git-po-helper, and
summarize quality checks plus optional agent integration in the PO
helper section.

Signed-off-by: Jiang Xin <worldhello.net@gmail.com>
maint
Jiang Xin 2026-04-03 14:40:01 +08:00
parent 6f8e885fd3
commit 82747b07cc
1 changed files with 21 additions and 6 deletions

View File

@ -399,15 +399,30 @@ Git's tests are run under `LANG=C LC_ALL=C`. So the tests do not need be
changed to account for translations as they're added.


## AI-assisted translation and review

[po/AGENTS.md](AGENTS.md) describes optional workflows for AI coding assistants
that help with Git localization: updating templates and PO files, translating
`po/XX.po`, and reviewing translations. Those workflows often use git-po-helper
together with the gettext tools; see the PO helper section below for what the
program does and how to build or install it. AI assistants are optional; treat
their output as a draft and have it reviewed by contributors who know Git and
the target language well.

When you prompt a coding assistant, mention that file explicitly, for example:
"Translate po/XX.po with reference to po/AGENTS.md" (replace XX with your
language code).


## PO helper

To make the maintenance of "XX.po" easier, the l10n coordinator and l10n
team leaders can use a helper program named "git-po-helper". It is a
wrapper to gettext suite, specifically written for the purpose of Git
l10n workflow.
`git-po-helper` is a helper for Git l10n coordinators and contributors. It
automates checks that contributions follow project conventions (PO syntax,
commit messages, which paths may change, and related rules) and can work with
AI coding agents for tasks such as translating new entries, and reviewing
translations.

To build and install the helper program from source, see
[git-po-helper/README][].
Build and install instructions are in [git-po-helper/README][].


## Conventions