Skip to contentSkip to conversation

docs: pt_BR: Reorganize process/index.rst to follow english structure

PATCH In review Daniel Pereira 2 participants 2 messages Aug 13

Subsystems (2)
lore
Share & tools
lore

Daniel Pereira

author maintainer
#0 lore raw

PATCH 1/1 docs: pt_BR: Reorganize process/index.rst to follow english structure

The main index.rst file for the pt_BR translation was grouping all translated process documents directly in its toctree, which frequently caused patch collisions among contributors.

Following Jonathan Corbet's suggestion, this patch introduces a new pt_BR/process/index.rst that mirrors the subsection structure of the English Documentation/process/index.rst. The translated documents are now organized into their respective categories, rather than a single flat list.

The root pt_BR/index.rst now simply references process/index.

This matches the upstream categorization and significantly reduces merge conflicts for future pt_BR translations.

---
 Documentation/translations/pt_BR/index.rst    |  27 +----
 .../translations/pt_BR/process/index.rst      | 104 ++++++++++++++++++
 2 files changed, 105 insertions(+), 26 deletions(-)
 create mode 100644 Documentation/translations/pt_BR/process/index.rst
Documentation/translations/pt_BR/index.rst +1 -26
index 1462b62d8..462267e92 100644
@@ -66,29 +66,4 @@ kernel e sobre como ver seu trabalho integrado.
 .. toctree::
    :maxdepth: 1
 
-   Introdução <process/1.Intro>
-   Guia do Processo de Desenvolvimento <process/development-process>
-   Como aplicar patches <process/applying-patches>
-   Backporting e resolução de conflitos <process/backporting>
-   Como não Deixar as ioctls malfeitas <process/botching-up-ioctls>
-   Index de documentos do Kernel <process/kernel-docs>
-   Regras de licenciamento <process/license-rules>
-   Como começar <process/howto>
-   Requisitos mínimos <process/changes>
-   CVEs <process/cve>
-   Conclave (Continuidade do projeto) <process/conclave>
-   Informações sobre clientes de email para Linux <process/email-clients>
-   Modelos de Maturidade para Contribuição no Kernel Linux <process/contribution-maturity-model.rst>
-   Manuais dos mantenedores <process/maintainer-handbooks>
-   Processo do subsistema de rede (netdev) <process/maintainer-netdev>
-   Processo do subsistema SoC <process/maintainer-soc>
-   Conformidade de DTS para SoC <process/maintainer-soc-clean-dts>
-   Estilo de gerenciamento do kernel Linux <process/management-style>
-   Processo do subsistema KVM x86 <process/maintainer-kvm-x86>
-   Adicionando uma nova chamada de Sistema <process/adding-syscalls>
-   Declaração sobre Drivers do Kernel <process/kernel-driver-statement>
-   Lista de verificação para submissão de patches do kernel Linux <process/submit-checklist>
-   Interpretação do Código de Conduta do Kernel Linux <process/code-of-conduct-interpretation>
-   Código de Conduta de Compromisso do Colaborador <process/code-of-conduct>
-   Interfaces, recursos de linguagem, atributos e convenções obsoletos <process/deprecated>
-   Falhas de segurança <process/security-bugs>
+   process/index
Documentation/translations/pt_BR/process/index.rst new file +104 -0

104 lines not on this page · raw message

Signature · 1 line
2.52.0
maintainer
#1 lore raw
Quoted 15 lines · Daniel Pereira

The main index.rst file for the pt_BR translation was grouping all translated process documents directly in its toctree, which frequently caused patch collisions among contributors.

Following Jonathan Corbet's suggestion, this patch introduces a new pt_BR/process/index.rst that mirrors the subsection structure of the English Documentation/process/index.rst. The translated documents are now organized into their respective categories, rather than a single flat list.

The root pt_BR/index.rst now simply references process/index.

This matches the upstream categorization and significantly reduces merge conflicts for future pt_BR translations.

Quoted 6 lines
---
 Documentation/translations/pt_BR/index.rst    |  27 +----
 .../translations/pt_BR/process/index.rst      | 104 ++++++++++++++++++
 2 files changed, 105 insertions(+), 26 deletions(-)
 create mode 100644 Documentation/translations/pt_BR/process/index.rst

OK, this is what I wanted to see. One complaint:

[...]

Quoted 6 lines
Documentation/translations/pt_BR/process/index.rst new file +0 -0
new file mode 100644
index 000000000..5cecc0300

Documentation/translations/pt_BR/process/index.rst line 8

Quoted 8 lines
Documentation/translations/pt_BR/process/index.rst new file +8 -0
@@ -0,0 +1,104 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. raw:: latex
+
+	\renewcommand\thesection*
+	\renewcommand\thesubsection*
+
+.. _process_index_pt_BR:

I continue my hopeless quest of trying to convince people not to add these useless top-of-file labels; all they do is add clutter to the text.

I have gone ahead and applied the patch so that people working on translations have the new base to work on for 7.4. But I took out that label.

(I have doubts about the LaTeX boilerplate too, but left it there).

Thanks,

jon