Linux Documentation
 help / color / mirror / Atom feed
From: Daniel Pereira <danielmaraboo@gmail.com>
To: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Subject: [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide
Date: Wed, 16 Sep 2026 14:41:30 -0300	[thread overview]
Message-ID: <20260916174136.48011-1-danielmaraboo@gmail.com> (raw)

This series has two parts.

Patches 1 and 5 fix cross-references across the existing pt_BR
translation.  Several documents pointed at the English version of files
that are already translated, so a reader of the translation was sent
back to the original.  In code-of-conduct.rst and cve.rst the effect was
visible in the rendered text, which quoted the English title of the
referenced document in the middle of a Portuguese sentence.  Nine pt_BR
anchors were missing and are added here; other translations already
define their own.  References whose target has no pt_BR translation are
left pointing at the English document.

Patches 2 to 4 start the admin-guide translation.  The index mirrors the
section layout of the original and lists the pending documents under a
Todolist marker, the same way zh_CN tracks its own, so that entries move
into a toctree as they get translated.  README.rst and devices.rst are
the first two documents.  For devices.rst the device registry itself is
pulled in with a literal include of the original devices.txt, keeping
the numbers in a single place.

The series was built with "make htmldocs" and produces no new warnings;
in particular there is no undefined label and no broken toctree entry.
checkpatch is clean apart from the usual "does MAINTAINERS need
updating?" advisory on the new files, which is already covered by
F: Documentation/translations/pt_BR/.

Daniel Pereira (5):
  docs: translations: pt_BR: point refs at the translated documents
  docs: translations: pt_BR: add admin-guide index
  docs: translations: pt_BR: translate admin-guide/README.rst
  docs: translations: pt_BR: translate admin-guide/devices.rst
  docs: translations: pt_BR: point howto.rst at the translated documents

 .../translations/pt_BR/admin-guide/README.rst | 382 ++++++++++++++++++
 .../pt_BR/admin-guide/devices.rst             | 278 +++++++++++++
 .../translations/pt_BR/admin-guide/index.rst  | 190 +++++++++
 Documentation/translations/pt_BR/index.rst    |  10 +
 .../pt_BR/process/adding-syscalls.rst         |   2 +-
 .../pt_BR/process/applying-patches.rst        |   2 +
 .../code-of-conduct-interpretation.rst        |   2 +
 .../pt_BR/process/code-of-conduct.rst         |   4 +-
 .../pt_BR/process/coding-style.rst            |   2 +
 .../translations/pt_BR/process/cve.rst        |   4 +-
 .../pt_BR/process/development-process.rst     |   2 +
 .../translations/pt_BR/process/howto.rst      |  19 +-
 .../pt_BR/process/kernel-docs.rst             |   2 +
 .../pt_BR/process/license-rules.rst           |   2 +
 .../pt_BR/process/maintainer-handbooks.rst    |   4 +-
 .../pt_BR/process/maintainer-kvm-x86.rst      |   4 +-
 .../process/maintainer-soc-clean-dts.rst      |   5 +-
 .../pt_BR/process/management-style.rst        |   9 +-
 .../pt_BR/process/security-bugs.rst           |  25 +-
 .../pt_BR/process/submit-checklist.rst        |   4 +-
 .../pt_BR/process/submitting-patches.rst      |   2 +
 21 files changed, 918 insertions(+), 36 deletions(-)
 create mode 100644 Documentation/translations/pt_BR/admin-guide/README.rst
 create mode 100644 Documentation/translations/pt_BR/admin-guide/devices.rst
 create mode 100644 Documentation/translations/pt_BR/admin-guide/index.rst

-- 
2.47.3


             reply	other threads:[~2026-09-16 17:41 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-09-16 17:41 Daniel Pereira [this message]
2026-09-16 17:41 ` [PATCH 1/5] docs: translations: pt_BR: point refs at the translated documents Daniel Pereira
2026-09-16 17:41 ` [PATCH 2/5] docs: translations: pt_BR: add admin-guide index Daniel Pereira
2026-09-16 17:41 ` [PATCH 3/5] docs: translations: pt_BR: translate admin-guide/README.rst Daniel Pereira
2026-09-16 17:41 ` [PATCH 4/5] docs: translations: pt_BR: translate admin-guide/devices.rst Daniel Pereira
2026-09-16 17:41 ` [PATCH 5/5] docs: translations: pt_BR: point howto.rst at the translated documents Daniel Pereira
2026-09-26 15:26 ` [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Jonathan Corbet

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260916174136.48011-1-danielmaraboo@gmail.com \
    --to=danielmaraboo@gmail.com \
    --cc=corbet@lwn.net \
    --cc=linux-doc@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox