All of lore.kernel.org
 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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.