Skip to contentSkip to conversation

docs: pt_BR: add netdev and maintainer handbook translations

PATCH Superseded Daniel Pereira 2 participants 4 messages Mar 9 – Mar 11

Subsystems (2)

v2 of 3 Superseded Latest is v3 →

lore
Share & tools
lore

Daniel Pereira

author maintainer
#0 lore raw

PATCH v2 1/1 docs: pt_BR: add netdev and maintainer handbook translations

Translate the netdev development process and the maintainer handbooks into Brazilian Portuguese. Also, update the main pt_BR index to link these documents.

---
v2:
- Fixed "Title level inconsistent" error in maintainer-netdev.rst (line 233).
- Corrected section header hierarchy and length to match Sphinx requirements.
- Fixed formatting errors in section headers (corrected "==" markers).
- Cleaned up trailing whitespaces to pass checkpatch.pl.
v1:
- Initial submission.

---
 Documentation/translations/pt_BR/index.rst    |   1 +
 .../pt_BR/process/maintainer-handbooks.rst    |  10 +-
 .../pt_BR/process/maintainer-netdev.rst       | 788 ++++++++++++++++++
 3 files changed, 798 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/pt_BR/process/maintainer-netdev.rst
Documentation/translations/pt_BR/index.rst +1 -0
index de5c005f9..8822e21cf 100644
@@ -69,3 +69,4 @@ kernel e sobre como ver seu trabalho integrado.
    Como começar <process/howto>
    Requisitos mínimos <process/changes>
    Manuais dos mantenedores <process/maintainer-handbooks>
+   Processo do subsistema de rede (netdev) <process/maintainer-netdev>
Documentation/translations/pt_BR/process/maintainer-handbooks.rst +9 -1
index eb650bc60..2d0a029e6 100644
@@ -5,4 +5,12 @@ Notas sobre o processo de desenvolvimento de subsistemas e mantenedores
 
 O propósito deste documento é fornecer informações específicas de
 subsistemas que são suplementares ao manual geral do processo de
-desenvolvimento :ref:`Documentation/process <development_process_main>`.
+desenvolvimento.
+
+Conteúdos:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 2
+
+   maintainer-netdev
\ No newline at end of file
Documentation/translations/pt_BR/process/maintainer-netdev.rst new file +788 -0

788 lines not on this page · raw message

Signature · 1 line
2.47.3
maintainer
#1 lore raw
Quoted 5 lines · Daniel Pereira

Translate the netdev development process and the maintainer handbooks into Brazilian Portuguese. Also, update the main pt_BR index to link these documents.

Quoted 8 lines

---
v2:
- Fixed "Title level inconsistent" error in maintainer-netdev.rst (line 233).
- Corrected section header hierarchy and length to match Sphinx requirements.
- Fixed formatting errors in section headers (corrected "==" markers).
- Cleaned up trailing whitespaces to pass checkpatch.pl.
v1:
- Initial submission.

A couple of minor notes follow...

Quoted 24 lines
 Documentation/translations/pt_BR/index.rst    |   1 +
 .../pt_BR/process/maintainer-handbooks.rst    |  10 +-
 .../pt_BR/process/maintainer-netdev.rst       | 788 ++++++++++++++++++
 3 files changed, 798 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/pt_BR/process/maintainer-netdev.rst
Documentation/translations/pt_BR/index.rst +1 -0
index de5c005f9..8822e21cf 100644
@@ -69,3 +69,4 @@ kernel e sobre como ver seu trabalho integrado.
    Como começar <process/howto>
    Requisitos mínimos <process/changes>
    Manuais dos mantenedores <process/maintainer-handbooks>
+   Processo do subsistema de rede (netdev) <process/maintainer-netdev>
Documentation/translations/pt_BR/process/maintainer-handbooks.rst +0 -1
index eb650bc60..2d0a029e6 100644
@@ -5,4 +5,12 @@ Notas sobre o processo de desenvolvimento de subsistemas e mantenedores
 
 O propósito deste documento é fornecer informações específicas de
 subsistemas que são suplementares ao manual geral do processo de
-desenvolvimento :ref:`Documentation/process <development_process_main>`.

Documentation/translations/pt_BR/process/maintainer-handbooks.rst Notas sobre o processo de desenvolvimento de subsistemas e mantenedores · line 16

Quoted 10 lines
Documentation/translations/pt_BR/process/maintainer-handbooks.rst +9 -0
+desenvolvimento.
+
+Conteúdos:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 2
+
+   maintainer-netdev
\ No newline at end of file

Files should have a final newline, you don't really want to see this in a diff. Most editors can be configured to ensure that the final newline is there.

Quoted 26 lines
Documentation/translations/pt_BR/process/maintainer-netdev.rst new file +20 -0
new file mode 100644
index 000000000..abda4fe70
@@ -0,0 +1,788 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+
+=====================================
+Subsistema de Rede do Linux (netdev)
+=====================================
+
+tl;dr
+-----
+
+- **Direcione seu patch para uma árvore** – use ``[PATCH net]``para correções
+  ou ``[PATCH net-next]`` para novas funcionalidades.
+- **Tag Fixes** – para correções, a tag ``Fixes:`` é obrigatória,
+  independentemente da árvore de destino.
+- **Tamanho da série** – não envie séries grandes (> 15 patches);divida-as em
+  partes menores.
+- **Intervalo de envio** – não reenvie seus patches dentro de um período de 24
+  horas.
+- **Reverse xmas tree** – organize as declarações de variáveis locais da mais
+  longa para a mais curta.

Documentation/translations/pt_BR/process/maintainer-netdev.rst line 30

Quoted 10 lines
Documentation/translations/pt_BR/process/maintainer-netdev.rst new file +10 -0
+
+netdev
+------
+A **netdev** é a lista de discussão para todos os assuntos do Linux
+relacionados
+a rede. Isso inclui qualquer item encontrado em ``net/`` (ex: código
+principal
+como IPv6) e  em ``drivers/net`` (ex: drivers específicos de hardware)
+na árvore
+de diretórios do Linux.

Why the strange line breaks throughout this file? That will make reading the plain text rather harder.

Thanks,

jon

author maintainer
#2 lore raw
Quoted 98 lines · Jonathan Corbet
Quoted 5 lines · Daniel Pereira

Translate the netdev development process and the maintainer handbooks into Brazilian Portuguese. Also, update the main pt_BR index to link these documents.

Quoted 8 lines

---
v2:
- Fixed "Title level inconsistent" error in maintainer-netdev.rst (line 233).
- Corrected section header hierarchy and length to match Sphinx requirements.
- Fixed formatting errors in section headers (corrected "==" markers).
- Cleaned up trailing whitespaces to pass checkpatch.pl.
v1:
- Initial submission.

A couple of minor notes follow...

Quoted 24 lines
 Documentation/translations/pt_BR/index.rst    |   1 +
 .../pt_BR/process/maintainer-handbooks.rst    |  10 +-
 .../pt_BR/process/maintainer-netdev.rst       | 788 ++++++++++++++++++
 3 files changed, 798 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/pt_BR/process/maintainer-netdev.rst
Documentation/translations/pt_BR/index.rst +1 -0
index de5c005f9..8822e21cf 100644
@@ -69,3 +69,4 @@ kernel e sobre como ver seu trabalho integrado.
    Como começar <process/howto>
    Requisitos mínimos <process/changes>
    Manuais dos mantenedores <process/maintainer-handbooks>
+   Processo do subsistema de rede (netdev) <process/maintainer-netdev>
Documentation/translations/pt_BR/process/maintainer-handbooks.rst +0 -1
index eb650bc60..2d0a029e6 100644
@@ -5,4 +5,12 @@ Notas sobre o processo de desenvolvimento de subsistemas e mantenedores
 
 O propósito deste documento é fornecer informações específicas de
 subsistemas que são suplementares ao manual geral do processo de
-desenvolvimento :ref:`Documentation/process <development_process_main>`.

Documentation/translations/pt_BR/process/maintainer-handbooks.rst Notas sobre o processo de desenvolvimento de subsistemas e mantenedores · line 16

Quoted 10 lines
Documentation/translations/pt_BR/process/maintainer-handbooks.rst +9 -0
+desenvolvimento.
+
+Conteúdos:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 2
+
+   maintainer-netdev
\ No newline at end of file

Files should have a final newline, you don't really want to see this in a diff. Most editors can be configured to ensure that the final newline is there.

Quoted 26 lines
Documentation/translations/pt_BR/process/maintainer-netdev.rst new file +20 -0
new file mode 100644
index 000000000..abda4fe70
@@ -0,0 +1,788 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+
+=====================================
+Subsistema de Rede do Linux (netdev)
+=====================================
+
+tl;dr
+-----
+
+- **Direcione seu patch para uma árvore** – use ``[PATCH net]``para correções
+  ou ``[PATCH net-next]`` para novas funcionalidades.
+- **Tag Fixes** – para correções, a tag ``Fixes:`` é obrigatória,
+  independentemente da árvore de destino.
+- **Tamanho da série** – não envie séries grandes (> 15 patches);divida-as em
+  partes menores.
+- **Intervalo de envio** – não reenvie seus patches dentro de um período de 24
+  horas.
+- **Reverse xmas tree** – organize as declarações de variáveis locais da mais
+  longa para a mais curta.

Documentation/translations/pt_BR/process/maintainer-netdev.rst line 30

Quoted 10 lines
Documentation/translations/pt_BR/process/maintainer-netdev.rst new file +10 -0
+
+netdev
+------
+A **netdev** é a lista de discussão para todos os assuntos do Linux
+relacionados
+a rede. Isso inclui qualquer item encontrado em ``net/`` (ex: código
+principal
+como IPv6) e  em ``drivers/net`` (ex: drivers específicos de hardware)
+na árvore
+de diretórios do Linux.

Why the strange line breaks throughout this file? That will make reading the plain text rather harder.

Quoted 3 lines

Thanks,

jon

Hi Jonathan,

I'm preparing v3. I've ensured a final newline in Documentation/translations/pt_BR/process/maintainer-handbooks.rst to address your previous comment.

However, during local testing of v3, I received a warning about a "new blank line at EOF" on one of the files. Could you please confirm if I should ensure the correct single final newline is present in both maintainer-handbooks.rst and the new file, maintainer-netdev.rst? I've also tried to address the "strange line breaks" in the latter.

I have a version of v3 ready to send if the newline fix is only required for maintainer-handbooks.rst.

Thanks,

Daniel

maintainer
#3 lore raw
Quoted 4 lines · Daniel Pereira

I'm preparing v3. I've ensured a final newline in Documentation/translations/pt_BR/process/maintainer-handbooks.rst to address your previous comment.

Quoted 8 lines

However, during local testing of v3, I received a warning about a "new blank line at EOF" on one of the files. Could you please confirm if I should ensure the correct single final newline is present in both maintainer-handbooks.rst and the new file, maintainer-netdev.rst? I've also tried to address the "strange line breaks" in the latter.

I have a version of v3 ready to send if the newline fix is only required for maintainer-handbooks.rst.

Go ahead and send v3. The others are worth fixing when you get a chance, but that can be a separate patch.

Thanks,

jon