Skip to content

Commit 82747b0

Browse files
committed
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>
1 parent 6f8e885 commit 82747b0

1 file changed

Lines changed: 21 additions & 6 deletions

File tree

po/README.md

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -399,15 +399,30 @@ Git's tests are run under `LANG=C LC_ALL=C`. So the tests do not need be
399399
changed to account for translations as they're added.
400400

401401

402+
## AI-assisted translation and review
403+
404+
[po/AGENTS.md](AGENTS.md) describes optional workflows for AI coding assistants
405+
that help with Git localization: updating templates and PO files, translating
406+
`po/XX.po`, and reviewing translations. Those workflows often use git-po-helper
407+
together with the gettext tools; see the PO helper section below for what the
408+
program does and how to build or install it. AI assistants are optional; treat
409+
their output as a draft and have it reviewed by contributors who know Git and
410+
the target language well.
411+
412+
When you prompt a coding assistant, mention that file explicitly, for example:
413+
"Translate po/XX.po with reference to po/AGENTS.md" (replace XX with your
414+
language code).
415+
416+
402417
## PO helper
403418

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

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

412427

413428
## Conventions

0 commit comments

Comments
 (0)