Re: [PATCH] Update l10n guide

From: Jiang Xin <worldhello.net@gmail.com>
Date: Mar 1, 2012, 04:05 UTC
Message-ID: <CANYiYbE5rcnD_VGJyL2CjS-R5E0pyNSd5TetvH849W6wC5JiAA@mail.gmail.com>
In-Reply-To: <7vfwduujxw.fsf_-_@alter.siamese.dyndns.org>

2012/2/29 Junio C Hamano <gitster@pobox.com>:

Show 5 quoted lines

> @@ -1,33 +1,78 @@
> +The localization (l10n) coordinator, Jiang Xin <worldhello.net@gmail.com>,
> +coordinates our localization effort in his repository:
> +
> +        https://github.com/gotgit/git-po/

I create a new dedicated team, named git-l10n, and transfer this repo to the new place: https://github.com/git-l10n/git-po/ for the following reasons:

 - git-po is a long-term repo, so has a dedicated, stabilized URL is better.
   The repo URL may not change if l10n coordinator change.

 - git-l10n is a github organization account, and has a dedicated owners
   group, who can assign new l10n coordinator.

 - Owners group of git-l10n organization will not receive pull requests to
   git-po. I add gister, avar to the owners team.

 - Members of the git-l10n-coordinators team of git-l10n organization
   will receive pull requests.

 - Some Chinese guys used to send pull request to gotgit/git-po, so you
   can find some closed pull requests written in Chinese. It won't happen
   after the repo transfer to git-l10n/git-po.

> +As a contributor for a language XX, you would fork this repository,

As a contributor for a language XX, you should first check TEAMS file in this directory to see whether a dedicated repository for your language XX exists. Fork the dedicated repository and start to work if it exists.

If you are the first contributor for the language XX, please fork this repository,

> +prepare and/or update the translated message file po/XX.po (described
> +later), and ask the l10n coordinator to pull your work.

Shall we remind the contributors for l10n to write commit log in English, but not language XX? It's a common mistake for translators.

Show 12 quoted lines

> diff --git a/po/TEAMS b/po/TEAMS
> new file mode 100644
> index 0000000..8ee6199
> --- /dev/null
> +++ b/po/TEAMS
> @@ -0,0 +1,10 @@
> +Core Git translation language teams
> +(please keep the list sorted alphabetically on language field)
> +
> +Language:      is (Icelandic)
> +Leader:                Ævar Arnfjörð Bjarmason <avarab@gmail.com>
> +

I think we should add the URL of the dedicated repository for language XX here. Example:

Language:      zh_CN (Simplified Chinese)
Leader:           Jiang Xin <worldhello.net@gmail.com>
Homepage:     https://github.com/jiangxin/git-po-zh_CN/

> +Members:       Yichao Yu <yyc1992@gmail.com>
> +               Riku <lu.riku@gmail.com>

Contributors and members can add to the header of the XX.po file. Add here may cause the TEAMS file grows rapidly.

-- 
Jiang Xin