* [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