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

[Daniel Pereira]

Hi Weijie,

On Thu, Oct 15, 2026 at 19:32 +0800, Weijie Yuan <wy@xxxxxxxxx> wrote:
> Thanks for doing this.

Thanks a lot for the review, and for confirming that a guide like this
was missing.

> Current practice of the field Original in zh_CN is:
>
> :Original: Documentation/xxx/xxx.rst

Agreed. The example now uses a plain path, and the guide notes that the
documentation build turns "Documentation/..." paths into links on its
own.

> 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.

> Requirement for "Assisted-by" trailer has been changed recently. ;-)

Right, I missed that. All the Assisted-by references are gone from the
guide (the AI tools section, the tags example and the checklist); it now
only says that Signed-off-by can only be added by the human who
certifies the contribution.

> Shall we Cc all the maintainers of translations for more comments?

Yes, good idea. I have prepared a v2 with these changes, rebased on
docs-next, and I am sending it with all the translation maintainers in
Cc, so that every team can comment.

Thanks,
Daniel