docs: pt_BR: add initial Portuguese translation

From: Daniel Pereira <[email protected]>

This patch introduces the initial Portuguese (Brazilian) translation for the Linux kernel documentation. It includes the mandatory disclaimer, the translation of the HOWTO document, and establishes the directory structure for the pt_BR locale.

---
v4:
- Removed unnecessary labels in all RST files as requested by Jon Corbet.
- Fixed alphabetical order in Documentation/translations/index.rst.
- Included the disclaimer in the documentation hierarchy to avoid orphan warnings.
- Added pt_BR support to Documentation/sphinx/translations.py.
- Updated MAINTAINERS and Signed-off-by with full name.

v3:
- Fix alphabetical order in MAINTAINERS file.
- Remove trailing whitespaces in RST files.
- Fix indentation in Documentation/translations/index.rst.

v2:
- Include pt_BR/index in the main translations index.

---
 Documentation/sphinx/translations.py          |   1 +
 Documentation/translations/index.rst          |   2 +
 .../translations/pt_BR/disclaimer-pt_BR.rst   |  11 +
 Documentation/translations/pt_BR/index.rst    |  69 ++
 .../translations/pt_BR/process/howto.rst      | 637 ++++++++++++++++++
 MAINTAINERS                                   |   6 +
 6 files changed, 726 insertions(+)
 create mode 100644 Documentation/translations/pt_BR/disclaimer-pt_BR.rst
 create mode 100644 Documentation/translations/pt_BR/index.rst
 create mode 100644 Documentation/translations/pt_BR/process/howto.rst

index 32c2b32b2..a03d4402b 100644
@@ -25,6 +25,7 @@ all_languages = {
     'it_IT': 'Italian',
     'ja_JP': 'Japanese',
     'ko_KR': 'Korean',
+    'pt_BR': 'Portuguese (Brazilian)',
     'sp_SP': 'Spanish',
 }
 

index b826c3479..409b6a84e 100644
@@ -11,10 +11,12 @@ Translations
    zh_TW/index
    it_IT/index
    ko_KR/index
+   pt_BR/index
    ja_JP/index
    sp_SP/index
 
 
+
 .. _translations_disclaimer:
 
 Disclaimer

new file mode 100644
index 000000000..3cae22c13
@@ -0,0 +1,11 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+
+
+Aviso sobre traduções para português
+====================================
+
+Esta documentação foi traduzida para português brasileiro por voluntários.
+Em caso de qualquer divergência entre esta tradução e o documento original
+em inglês, a versão em inglês (encontrada no diretório Documentation/)
+deve ser considerada a única fonte de verdade.

index 0efa8cc67..dd03046be 100644
@@ -21141,6 +21141,12 @@ F:	include/sound/pxa2xx-lib.h
 F:	sound/arm/pxa*
 F:	sound/soc/pxa/
 
+PORTUGUESE (BRAZILIAN) TRANSLATION
+M:	Daniel Pereira <[email protected]>
+L:	[email protected]
+S:	Maintained
+F:	Documentation/translations/pt_BR/
+
 QAT DRIVER
 M:	Giovanni Cabiddu <[email protected]>
 L:	[email protected]

2.43.0

Hi,
One more nit, sorry.

Documentation/process/submitting-patches.rst says:

Describe your changes in imperative mood, e.g. "make xyzzy do frotz" instead of "[This patch] makes xyzzy do frotz" or "[I] changed xyzzy to do frotz", as if you are giving orders to the codebase to change its behaviour.

so something like

Introduce the initial ...

would be good.

~Randy

Hi Randy,

Thanks for catching that. I'll rephrase the opening line in v5 to use the imperative mood as suggested by submitting-patches.rst.

Best regards,

Daniel

Hi Randy,

Thank you for the correction. I will adjust the description to use the imperative mood in the v5 patch.

Hi Matthew,

I will remove this extra line. It was an oversight during the reorganization of the file.

Regarding the heading, as this is an initial patch focused on establishing the structure and the first main documents, some non-essential headings remained in English. However, my plan is to provide the full translation of all internal headings and content in the upcoming patches.

This is an important point. While Brazilian and European Portuguese are mutually intelligible, the technical terminology and sentence construction in a professional context differ significantly.

In Brazil, the community of developers and students is vast, and providing documentation in pt_BR is crucial to lowering the entry barrier and ensuring that technical nuances are perfectly understood without the "distraction" of regional variations from Portugal, which can sometimes sound archaic or confusing to a Brazilian developer. By starting with pt_BR, we are targeting the largest Portuguese-speaking developer base to ensure high-quality contributions from the start.

I am preparing v5 now with these fixes.

Best regards,

Daniel Pereira