Re: [PATCH 1/2] docs: doc-guide: add a guide for translators

[Dongliang Mu <dzm91@hust.edu.cn>]

On 10/15/26 10:03 PM, Weijie Yuan wrote:
> +cc zh_CN maintainers
>
> On 2026-10-15 07:50:40 -0600, Jonathan Corbet <corbet@lwn.net> wrote:
>
>> Weijie Yuan <wy@wyuan.org> writes:
>>
>>>>> For the Translator field, zh_TW just did a cleanup to totally remove
>>>>> them.
>>>> Makes sense. I dropped the ":Translator:" line from the example, and the
>>>> guide keeps the advice to leave contact information to MAINTAINERS.
>>> I personally think this is somehow a hard tradeoff, so my opinion is
>>> rather neutral, and I respect your decisions.
>>>
>>> On the one hand, I think keeping this field is indeed a way to give
>>> credit to the contributors, which can motivate more contributions and
>>> contributors. On the other hand, over the years, this field has seemed a
>>> bit cumbersome and inconsistent in both Chinese translations.
>> I personally don't see why translations are different from any other
>> contribution in this regard.  The credit lives in the commit logs; we
>> don't sprinkle our names throughout the source for every change we make.
> Yes, very reasonable.
>
> I haven't found out the reason why we had the "Translator" field at the
> very beginning. I guess it might be something like translating a book.
> Usually, the translator's name would be written below/near the original
> author's name on the title page. (?) However, the difference is that we
> have commit logs, so I totally agree.
Cannot agree more on this statement.
> Then perhaps we could also clean up zh_CN later.

We will also clean up these fields in the zh_CN translation.

Dongliang Mu

>
> Thanks!