Re: [PATCH v2 0/2] docs: add a guide for translators

[Carlos Bilbao <carlos.bilbao.osdev@gmail.com>]

On 10/15/26 05:56, Daniel Pereira wrote:

> The documentation has seven translations, but the English documentation
> has no guide on how to contribute to them; the only one that exists,
> Documentation/translations/zh_CN/how-to.rst, is in Chinese and covers
> zh_CN only. As a result, the same problems keep coming up in the review
> of translation patches: labels copied from the original that collide
> with the English ones, partial builds that hide those collisions,
> documents left out of any toctree, missing commit descriptions and
> missing recipients.
>
> Patch 1 adds Documentation/doc-guide/translations.rst, a guide that
> covers the whole workflow of a translation, from choosing what to
> translate to sending the patch and keeping the translation up to date.
>
> Patch 2 translates the guide into Brazilian Portuguese. Since it is
> based on the original added by patch 1, whose commit hash is only known
> once the series is applied, it does not carry the "Update the
> translation through commit" line that the guide suggests.
>
> Both patches were checked with a full "make htmldocs" build, with no new
> warnings, and with scripts/checkpatch.pl --strict.
>
> Changes in v2:
> - Drop the references to the Assisted-by tag, which was removed from
>    coding-assistants.rst and submitting-patches.rst by commit 1e035297ffda
>    ("docs: remove Assisted-by references"). The guide now only says that
>    Signed-off-by can only be added by the human who certifies the
>    contribution (Weijie Yuan).
> - Use a plain path in the ":Original:" example, which is what most
>    translations do and which the documentation build already turns into
>    a link, and drop the ":Translator:" line from it (Weijie Yuan).
> - Rebase on current docs-next.
> - Cc the translation maintainers, so that every team can comment.
>
> v1: https://lore.kernel.org/linux-doc/20261013003702.5824-1-danielmaraboo@gmail.com/
>
> Daniel Pereira (2):
>    docs: doc-guide: add a guide for translators
>    docs: pt_BR: translate doc-guide/translations.rst
>
>   Documentation/doc-guide/index.rst             |   1 +
>   Documentation/doc-guide/translations.rst      | 694 +++++++++++++++++
>   Documentation/translations/index.rst          |   3 +
>   .../translations/pt_BR/doc-guide/index.rst    |  19 +
>   .../pt_BR/doc-guide/translations.rst          | 711 ++++++++++++++++++
>   Documentation/translations/pt_BR/index.rst    |  11 +
>   6 files changed, 1439 insertions(+)
>   create mode 100644 Documentation/doc-guide/translations.rst
>   create mode 100644 Documentation/translations/pt_BR/doc-guide/index.rst
>   create mode 100644 Documentation/translations/pt_BR/doc-guide/translations.rst
>
>
> base-commit: 90d9f76ccb72ec024ef476b4229f3dd1957d7b26


Acked-by: Carlos Bilbao <carlos.bilbao@kernel.org>