Linux Documentation
 help / color / mirror / Atom feed
* [PATCH] docs: pt_BR: Reorganize index.rst to avoid merge conflicts
@ 2026-07-27 11:52 Daniel Pereira
  0 siblings, 0 replies; only message in thread
From: Daniel Pereira @ 2026-07-27 11:52 UTC (permalink / raw)
  To: corbet; +Cc: linux-doc, Daniel Pereira

The main index.rst file for the pt_BR translation was grouping all
translated documents directly in its toctree. Because many contributors
are submitting translations simultaneously to the same file, it has
become a bottleneck, causing frequent merge conflicts.

To solve this issue and improve maintainability, this patch refactors
the structure to follow the pattern used by the base English
documentation. Specifically, a new index.rst was created inside the
process/ directory to handle all future contributions and document
additions targeting that specific directory.

The root index.rst now simply references process/index.rst. This
modular organization keeps the main tree clean and significantly
reduces patch collisions.

Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
 Documentation/translations/pt_BR/index.rst    | 28 +--------------
 .../translations/pt_BR/process/index.rst      | 34 +++++++++++++++++++
 2 files changed, 35 insertions(+), 27 deletions(-)
 create mode 100644 Documentation/translations/pt_BR/process/index.rst

diff --git a/Documentation/translations/pt_BR/index.rst b/Documentation/translations/pt_BR/index.rst
index 232d18f7c..e868544d1 100644
--- a/Documentation/translations/pt_BR/index.rst
+++ b/Documentation/translations/pt_BR/index.rst
@@ -1,7 +1,5 @@
 .. SPDX-License-Identifier: GPL-2.0
 
-
-
 =========================================
 Documentação do Kernel Linux em Português
 =========================================
@@ -22,8 +20,6 @@ na reorganização da documentação de forma mais coerente. Melhorias na
 documentação são sempre bem-vindas; se você deseja ajudar, inscreva-se na lista
 de discussão linux-doc em vger.kernel.org.
 
-
-
 Avisos
 ======
 
@@ -66,26 +62,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>
-   Conclave (Continuidade do projeto) <process/conclave>
-   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>
-   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>
-
+   Todos os documentos do processo de desenvolvimento <process/index>
diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst
new file mode 100644
index 000000000..b3518fe72
--- /dev/null
+++ b/Documentation/translations/pt_BR/process/index.rst
@@ -0,0 +1,34 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+================================================
+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
+
+   Introdução <1.Intro>
+   Guia do Processo de Desenvolvimento <development-process>
+   Como aplicar patches <applying-patches>
+   Backporting e resolução de conflitos <backporting>
+   Como não Deixar as ioctls malfeitas <botching-up-ioctls>
+   Index de documentos do Kernel <kernel-docs>
+   Regras de licenciamento <license-rules>
+   Como começar <howto>
+   Requisitos mínimos <changes>
+   Conclave (Continuidade do projeto) <conclave>
+   Modelos de Maturidade para Contribuição no Kernel Linux <contribution-maturity-model>
+   Manuais dos mantenedores <maintainer-handbooks>
+   Processo do subsistema de rede (netdev) <maintainer-netdev>
+   Processo do subsistema SoC <maintainer-soc>
+   Conformidade de DTS para SoC <maintainer-soc-clean-dts>
+   Processo do subsistema KVM x86 <maintainer-kvm-x86>
+   Adicionando uma nova chamada de Sistema <adding-syscalls>
+   Declaração sobre Drivers do Kernel <kernel-driver-statement>
+   Lista de verificação para submissão de patches do kernel Linux <submit-checklist>
+   Interpretação do Código de Conduta do Kernel Linux <code-of-conduct-interpretation>
+   Código de Conduta de Compromisso do Colaborador <code-of-conduct>
+   Interfaces, recursos de linguagem, atributos e convenções obsoletos <deprecated>
-- 
2.52.0


^ permalink raw reply related	[flat|nested] only message in thread

only message in thread, other threads:[~2026-07-27 11:53 UTC | newest]

Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-07-27 11:52 [PATCH] docs: pt_BR: Reorganize index.rst to avoid merge conflicts Daniel Pereira

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox