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

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

[Daniel Pereira]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=y, Size: 6795 bytes --]

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.

Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
 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

diff --git a/Documentation/translations/pt_BR/index.rst b/Documentation/translations/pt_BR/index.rst
index 1462b62d8..462267e92 100644
--- a/Documentation/translations/pt_BR/index.rst
+++ b/Documentation/translations/pt_BR/index.rst
@@ -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
diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst
new file mode 100644
index 000000000..5cecc0300
--- /dev/null
+++ b/Documentation/translations/pt_BR/process/index.rst
@@ -0,0 +1,104 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. raw:: latex
+
+	\renewcommand\thesection*
+	\renewcommand\thesubsection*
+
+.. _process_index_pt_BR:
+
+===============================================
+Trabalhando com a comunidade de desenvolvimento
+===============================================
+
+Então você quer ser um desenvolvedor do kernel Linux? Bem-vindo! Embora haja
+muito a aprender sobre o kernel em um sentido técnico, também é importante
+aprender como nossa comunidade funciona. A leitura desses documentos tornará
+muito mais fácil para você ter suas alterações integradas com um mínimo de
+problemas.
+
+Uma introdução sobre como funciona o desenvolvimento do kernel
+--------------------------------------------------------------
+
+Leia estes documentos primeiro: entender este material facilitará
+sua entrada na comunidade do kernel.
+
+.. toctree::
+   :maxdepth: 1
+
+   Como começar <howto>
+   Guia do Processo de Desenvolvimento <development-process>
+   Lista de verificação para submissão de patches do kernel Linux <submit-checklist>
+
+Ferramentas e guias técnicos para desenvolvedores do kernel
+-----------------------------------------------------------
+
+Esta é uma coleção de material com o qual os desenvolvedores do kernel
+devem estar familiarizados.
+
+.. toctree::
+   :maxdepth: 1
+
+   Requisitos mínimos <changes>
+   Informações sobre clientes de email para Linux <email-clients>
+   Como aplicar patches <applying-patches>
+   Backporting e resolução de conflitos <backporting>
+   Adicionando uma nova chamada de Sistema <adding-syscalls>
+   Como não Deixar as ioctls malfeitas <botching-up-ioctls>
+
+Guias de políticas e declarações de desenvolvedores
+---------------------------------------------------
+
+Estas são as regras pelas quais tentamos viver na comunidade do kernel
+(e além).
+
+.. toctree::
+   :maxdepth: 1
+
+   Regras de licenciamento <license-rules>
+   Código de Conduta de Compromisso do Colaborador <code-of-conduct>
+   Interpretação do Código de Conduta do Kernel Linux <code-of-conduct-interpretation>
+   Modelos de Maturidade para Contribuição no Kernel Linux <contribution-maturity-model.rst>
+   Declaração sobre Drivers do Kernel <kernel-driver-statement>
+   Estilo de gerenciamento do kernel Linux <management-style>
+   Conclave (Continuidade do projeto) <conclave>
+
+Lidando com bugs
+----------------
+
+Bugs são uma realidade; é importante lidarmos com eles de forma correta.
+Os documentos abaixo detalham políticas e conselhos em relação ao
+gerenciamento de bugs e vulnerabilidades.
+
+.. toctree::
+   :maxdepth: 1
+
+   Falhas de segurança <security-bugs>
+   CVEs <cve>
+
+Informações para mantenedores
+-----------------------------
+
+Como encontrar as pessoas que aceitarão seus patches e manuais úteis para os
+mantenedores de subsistemas.
+
+.. toctree::
+   :maxdepth: 1
+
+   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>
+
+Outros materiais
+----------------
+
+Aqui estão alguns outros guias para a comunidade que são de interesse para
+a maioria dos desenvolvedores:
+
+.. toctree::
+   :maxdepth: 1
+
+   Index de documentos do Kernel <kernel-docs>
+   Interfaces, recursos de linguagem, atributos e convenções obsoletos <deprecated>
-- 
2.52.0

Re: [PATCH] docs: pt_BR: Reorganize process/index.rst to follow english structure

[Jonathan Corbet]

Daniel Pereira <danielmaraboo@gmail.com> writes:

> 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.
>
> Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
> ---
>  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:

[...]

> diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst
> new file mode 100644
> index 000000000..5cecc0300
> --- /dev/null
> +++ b/Documentation/translations/pt_BR/process/index.rst
> @@ -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