docs: pt_BR: add initial Portuguese translation

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.

Signed-off-by Daniel Pereira <[email protected]>

---
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/translations/index.rst          |   1 +
 .../translations/pt_BR/disclaimer-pt_BR.rst   |  11 +
 Documentation/translations/pt_BR/index.rst    |  67 ++
 .../translations/pt_BR/process/howto.rst      | 637 ++++++++++++++++++
 MAINTAINERS                                   |   8 +
 5 files changed, 724 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

Documentation/translations/index.rst +0 -0

index b826c3479..b799eacb8 100644

Documentation/translations/pt_BR/disclaimer-pt_BR.rst new file +7 -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.

Documentation/translations/pt_BR/index.rst new file +0 -0

new file mode 100644
index 000000000..f0e229568

Documentation/translations/pt_BR/index.rst new file +11 -0

+=========================================
+Documentação do Kernel Linux em Português
+=========================================
+
+.. raw:: latex
+
+	\kerneldocCJKoff
+
+:mantenedor: Daniel <[email protected]>
+
+Este é o nível principal da documentação do kernel em língua portuguesa (Brasil).

Documentation/translations/pt_BR/index.rst new file +41 -0

+Avisos
+======
+
+O objetivo desta tradução é facilitar a leitura e compreensão para aqueles que
+não dominam o inglês ou têm dúvidas sobre sua interpretação, ou simplesmente
+para quem prefere ler em sua língua nativa. No entanto, tenha em mente que a
+*única* documentação oficial é a em língua inglesa: :ref:`linux_doc`
+
+A propagação simultânea de uma alteração em :ref:`linux_doc` para todas as
+traduções é altamente improvável. Os mantenedores das traduções — e seus
+contribuidores — acompanham a evolução da documentação oficial e tentam manter
+as respectivas traduções alinhadas na medida do possível. Por este motivo, não
+há garantia de que uma tradução esteja atualizada com a última modificação.
+Se o que você ler em uma tradução não corresponder ao que ler no código,
+informe o mantenedor da tradução e — se puder — verifique também a
+documentação em inglês.
+
+Uma tradução não é um *fork* da documentação oficial; portanto, os usuários não
+encontrarão nela informações diferentes daquelas contidas na versão oficial.
+Qualquer adição, remoção ou modificação de conteúdo deve ser feita primeiro nos
+documentos em inglês. Posteriormente, quando possível, a mesma alteração deve
+ser aplicada às traduções. Os mantenedores das traduções aceitam contribuições
+que afetem puramente a atividade de tradução (por exemplo, novas traduções,
+atualizações, correções).
+
+As traduções buscam ser o mais precisas possível, mas não é possível mapear
+diretamente uma língua em outra. Cada língua possui sua própria gramática e
+cultura, portanto, a tradução de uma frase em inglês pode ser modificada para
+se adaptar ao português. Por esse motivo, ao ler esta tradução, você poderá
+encontrar algumas diferenças de forma, mas que transmitem a mensagem original.
+
+Trabalhando com a comunidade de desenvolvimento
+===============================================
+
+As guias fundamentais para a interação com a comunidade de desenvolvimento do
+kernel e sobre como ver seu trabalho integrado.
+
+.. toctree::
+   :maxdepth: 1
+
+   Como começar <process/howto>

Documentation/translations/pt_BR/process/howto.rst new file +0 -0

new file mode 100644
index 000000000..43a2be263

I have addressed all the technical points you raised. Additionally, I discovered that pt_BR was missing in Documentation/translations.py and I have now added it to ensure full build support.

Regarding the role of a maintainer for a new language: is there a specific vetting process or "test" one must undergo to assume this responsibility?

I am a Systems Engineer at a data center in Brazil (HostDime) and a Linux instructor at events such as DevOps Days and Debian Day. My goal is to coordinate a larger translation effort with my students and the local community to provide high-quality documentation in Portuguese across the entire country.

One other point of order: never remove the list CCs. We do our development in the open.

Quoted 6 lines · Daniel Pereira

I have addressed all the technical points you raised. Additionally, I discovered that pt_BR was missing in Documentation/translations.py and I have now added it to ensure full build support.

Regarding the role of a maintainer for a new language: is there a specific vetting process or "test" one must undergo to assume this responsibility?

Not really. The main responsibility at this point will be to review translation patches; I will generally hold off on applying translations until I see a review from somebody who can understand them properly.

Quoted 5 lines

I am a Systems Engineer at a data center in Brazil (HostDime) and a Linux instructor at events such as DevOps Days and Debian Day. My goal is to coordinate a larger translation effort with my students and the local community to provide high-quality documentation in Portuguese across the entire country.

This is find. What I would recommend is to go through a review process internally with your students, then have them post the patches publicly once they appear to be in good shape.

Thanks,

jon

MAINTAINERS +6 -0

index 0efa8cc67..c5e0e1f2b 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]

Hi,

Quoted 18 lines · Daniel Pereira

MAINTAINERS +6 -0

index 0efa8cc67..c5e0e1f2b 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]

@@ -28876,3 +28882,5 @@ S:    Buried alive in reporters

MAINTAINERS S: Buried alive in reporters · line 28886

Quoted 5 lines

MAINTAINERS +2 -0

 T:   git git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
 F:   *
 F:   */
+
+

Don't add extra blank lines at the end of this file. I.e., that entire last diff block shouldn't be here.