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

[Daniel Pereira]

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@xxxxxxxxx/

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