[PATCH v3] docs: translations: pt_BR: translate stable-kernel-rules.rst

[PATCH v3] docs: translations: pt_BR: translate stable-kernel-rules.rst

[Fabio Pereira da Silva]

Translate stable-kernel-rules.rst into Brazilian Portuguese and add it
to the pt_BR process documentation index.

Signed-off-by: Fabio Pereira da Silva <silvapfabio@gmail.com>
---
Changes in v3:
- Remove Assisted-by trailer.

Changes in v2:
- Add document to Documentation/translations/pt_BR/process/index.rst
  instead of the top-level index.
- Remove top-of-file Sphinx label to prevent build error.
- Fix title underline length.

v2: https://lore.kernel.org/r/20260910190754.1687-1-silvapfabio@gmail.com
v1: https://lore.kernel.org/r/20260910151204.1248-1-silvapfabio@gmail.com

 .../translations/pt_BR/process/index.rst      |   1 +
 .../pt_BR/process/stable-kernel-rules.rst     | 247 ++++++++++++++++++
 2 files changed, 248 insertions(+)
 create mode 100644 Documentation/translations/pt_BR/process/stable-kernel-rules.rst

diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst
index 7841eca..0e72c45 100644
--- a/Documentation/translations/pt_BR/process/index.rst
+++ b/Documentation/translations/pt_BR/process/index.rst
@@ -59,6 +59,7 @@ Estas são as regras pelas quais tentamos viver na comunidade do kernel
    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>
+   Tudo sobre lançamentos -stable <stable-kernel-rules>
    Estilo de gerenciamento do kernel Linux <management-style>
    Assistentes de código <coding-assistants>
    Conclave (Continuidade do projeto) <conclave>
diff --git a/Documentation/translations/pt_BR/process/stable-kernel-rules.rst b/Documentation/translations/pt_BR/process/stable-kernel-rules.rst
new file mode 100644
index 0000000..8f732c4
--- /dev/null
+++ b/Documentation/translations/pt_BR/process/stable-kernel-rules.rst
@@ -0,0 +1,247 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+Tudo o que você sempre quis saber sobre lançamentos -stable do Linux
+====================================================================
+
+Regras sobre que tipo de patches são aceitos, e quais não são, na árvore
+"-stable":
+
+- O patch ou uma correção equivalente já deve existir na mainline do Linux
+  (upstream).
+- Deve ser obviamente correto e testado.
+- Não pode ter mais de 100 linhas, incluindo contexto.
+- Deve seguir as regras de
+  :ref:`Documentation/process/submitting-patches.rst <submittingpatches>`.
+- Deve corrigir um bug real que incomoda as pessoas ou apenas adicionar um ID
+  de dispositivo. Detalhando o primeiro caso:
+
+  - Corrige um problema como um oops, uma travada (hang), corrupção de dados,
+    uma questão real de segurança, uma peculiaridade de hardware, um erro de
+    compilação (mas não para coisas marcadas como CONFIG_BROKEN), ou algum
+    problema do tipo "isso não é bom".
+  - Problemas sérios relatados por um usuário de um kernel de distribuição
+    também podem ser considerados se corrigirem um problema notável de
+    desempenho ou de interatividade. Como essas correções não são tão óbvias
+    e têm um risco maior de uma regressão sutil, elas só devem ser enviadas
+    por um mantenedor de kernel de distribuição e devem incluir um adendo
+    apontando para uma entrada no bugzilla, se existir, e informações
+    adicionais sobre o impacto visível para o usuário.
+  - Nada do tipo "isso poderia ser um problema...", como uma "condição de
+    corrida teórica", a menos que uma explicação de como o bug pode ser
+    explorado também seja fornecida.
+  - Nenhuma correção "trivial" sem benefício para os usuários (mudanças de
+    ortografia, limpeza de espaços em branco, etc.).
+
+
+Procedimento para submeter patches para a árvore -stable
+---------------------------------------------------------
+
+.. note::
+
+   Patches de segurança não devem ser tratados (apenas) pelo processo de
+   revisão -stable, mas devem seguir os procedimentos descritos em
+   :ref:`Documentation/process/security-bugs.rst <securitybugs>`.
+
+Existem três opções para submeter uma alteração para as árvores -stable:
+
+1. Adicionar uma 'tag stable' à descrição de um patch que você então submete
+   para inclusão na mainline.
+2. Pedir para o time -stable pegar um patch que já está na mainline.
+3. Submeter ao time -stable um patch equivalente a uma alteração já presente
+   na mainline.
+
+As seções abaixo descrevem cada uma das opções em mais detalhes.
+
+:ref:`option_1` é **fortemente** preferida, é a mais fácil e mais comum.
+:ref:`option_2` é voltada principalmente para alterações em que o backport
+não foi considerado no momento da submissão. :ref:`option_3` é uma alternativa
+às duas opções anteriores para os casos em que um patch já presente na
+mainline precisa de ajustes para se aplicar em séries mais antigas (por
+exemplo, devido a mudanças de API).
+
+Ao usar a opção 2 ou 3, você pode pedir que sua alteração seja incluída em
+séries -stable específicas. Ao fazer isso, garanta que a correção ou uma
+equivalente seja aplicável, submetida, ou já esteja presente em todas as
+árvores -stable mais novas ainda suportadas. Isso serve para evitar
+regressões que os usuários possam encontrar posteriormente ao atualizar, se,
+por exemplo, uma correção mesclada para a 5.19-rc1 fosse retroportada para a
+5.10.y, mas não para a 5.15.y.
+
+.. _option_1:
+
+Opção 1
+*******
+
+Para que um patch que você submete para inclusão na mainline seja
+automaticamente pego para as árvores -stable posteriormente, adicione esta
+tag na área de sign-off::
+
+  Cc: stable@vger.kernel.org
+
+Use ``Cc: stable@kernel.org`` em vez disso ao corrigir vulnerabilidades ainda
+não publicadas: isso reduz a chance de expor acidentalmente a correção ao
+público por meio do 'git send-email', já que e-mails enviados para esse
+endereço não são entregues a lugar nenhum.
+
+Depois que o patch é mesclado na mainline, ele será aplicado à árvore stable
+sem que nada mais precise ser feito pelo autor ou pelo mantenedor do
+subsistema.
+
+Para enviar instruções adicionais ao time -stable, use um comentário embutido
+no estilo shell para passar notas arbitrárias ou predefinidas:
+
+* Especifique quaisquer pré-requisitos adicionais de patches para cherry
+  picking::
+
+    Cc: <stable@vger.kernel.org> # 3.3.x: a1f84a3: sched: Check for idle
+    Cc: <stable@vger.kernel.org> # 3.3.x: 1b9508f: sched: Rate-limit newidle
+    Cc: <stable@vger.kernel.org> # 3.3.x: fd21073: sched: Fix affinity logic
+    Cc: <stable@vger.kernel.org> # 3.3.x
+    Signed-off-by: Ingo Molnar <mingo@elte.hu>
+
+  A sequência de tags tem o significado de::
+
+    git cherry-pick a1f84a3
+    git cherry-pick 1b9508f
+    git cherry-pick fd21073
+    git cherry-pick <this commit>
+
+  Note que, para uma série de patches, você não precisa listar como
+  pré-requisitos os patches presentes na própria série. Por exemplo, se você
+  tiver a seguinte série de patches::
+
+    patch1
+    patch2
+
+  em que patch2 depende de patch1, você não precisa listar patch1 como
+  pré-requisito de patch2 se já tiver marcado patch1 para inclusão em stable.
+
+* Aponte pré-requisitos de versão do kernel::
+
+    Cc: <stable@vger.kernel.org> # 3.3.x
+
+  A tag tem o significado de::
+
+    git cherry-pick <this commit>
+
+  Para cada árvore "-stable" a partir da versão especificada.
+
+  Note que essa marcação é desnecessária se o time -stable puder derivar as
+  versões apropriadas a partir das tags Fixes:.
+
+* Atrase a coleta de patches::
+
+    Cc: <stable@vger.kernel.org> # after -rc3
+
+* Aponte problemas conhecidos::
+
+    Cc: <stable@vger.kernel.org> # see patch description, needs adjustments for <= 6.3
+
+Existe ainda uma variante da tag stable que você pode usar para fazer com que
+as ferramentas de backport do time -stable (por exemplo, AUTOSEL ou scripts
+que procuram commits contendo uma tag 'Fixes:') ignorem uma alteração::
+
+     Cc: <stable+noautosel@kernel.org> # reason goes here, and must be present
+
+.. _option_2:
+
+Opção 2
+*******
+
+Se o patch já foi mesclado na mainline, envie um e-mail para
+stable@vger.kernel.org contendo o assunto do patch, o ID do commit, por que
+você acha que ele deve ser aplicado, e para quais versões do kernel você
+deseja que ele seja aplicado.
+
+.. _option_3:
+
+Opção 3
+*******
+
+Envie o patch, depois de verificar que ele segue as regras acima, para
+stable@vger.kernel.org e mencione as versões do kernel para as quais deseja
+que ele seja aplicado. Ao fazer isso, você deve anotar o ID do commit
+upstream no changelog da sua submissão em uma linha separada acima do texto
+do commit, assim::
+
+  commit <sha1> upstream.
+
+Ou, alternativamente::
+
+  [ Upstream commit <sha1> ]
+
+Se o patch submetido se desviar do patch upstream original (por exemplo,
+porque precisou ser ajustado para uma API mais antiga), isso deve ser muito
+claramente documentado e justificado na descrição do patch.
+
+
+Após a submissão
+------------------
+
+O remetente receberá um ACK quando o patch tiver sido aceito na fila, ou um
+NAK se o patch for rejeitado. Essa resposta pode levar alguns dias, de acordo
+com a agenda dos membros do time -stable.
+
+Se aceito, o patch será adicionado à fila -stable, para revisão por outros
+desenvolvedores e pelo mantenedor relevante do subsistema.
+
+
+Ciclo de revisão
+------------------
+
+- Quando os mantenedores -stable decidem por um ciclo de revisão, os patches
+  serão enviados ao comitê de revisão, e ao mantenedor da área afetada pelo
+  patch (a menos que o submissor seja o mantenedor da área), com CC: para a
+  lista de discussão linux-kernel.
+- O comitê de revisão tem 48 horas para dar ACK ou NAK ao patch.
+- Se o patch for rejeitado por um membro do comitê, ou se membros da
+  linux-kernel se opuserem ao patch, levantando questões que os mantenedores
+  e membros não perceberam, o patch será removido da fila.
+- Os patches que receberam ACK serão postados novamente como parte de um
+  release candidate (-rc) para serem testados por desenvolvedores e
+  testadores.
+- Normalmente, apenas um lançamento -rc é feito; porém, se houver quaisquer
+  problemas pendentes, alguns patches podem ser modificados ou removidos, ou
+  patches adicionais podem ser enfileirados. Lançamentos -rc adicionais são
+  então lançados e testados até que nenhum problema seja encontrado.
+- Responder aos lançamentos -rc pode ser feito na lista de discussão enviando
+  um e-mail "Tested-by:" com qualquer informação de teste desejada. As tags
+  "Tested-by:" serão coletadas e adicionadas ao commit de lançamento.
+- Ao final do ciclo de revisão, o novo lançamento -stable será lançado
+  contendo todos os patches enfileirados e testados.
+- Patches de segurança serão aceitos na árvore -stable diretamente pelo time
+  de segurança do kernel, e não passarão pelo ciclo normal de revisão.
+  Entre em contato com o time de segurança do kernel para mais detalhes
+  sobre esse procedimento.
+
+
+Árvores
+--------
+
+- As filas de patches, tanto para versões concluídas quanto para versões em
+  andamento, podem ser encontradas em:
+
+    https://git.kernel.org/pub/scm/linux/kernel/git/stable/stable-queue.git
+
+- Os lançamentos finalizados e marcados de todos os kernels stable podem ser
+  encontrados em branches separados por versão em:
+
+    https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
+
+- O release candidate de todas as versões do kernel stable pode ser
+  encontrado em:
+
+    https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable-rc.git/
+
+  .. warning::
+     A árvore -stable-rc é um snapshot no tempo da árvore stable-queue e
+     mudará com frequência, sendo portanto rebaseada com frequência. Ela deve
+     ser usada apenas para fins de teste (por exemplo, para ser consumida por
+     sistemas de CI).
+
+
+Comitê de revisão
+-------------------
+
+- É composto por vários desenvolvedores do kernel que se voluntariaram para
+  essa tarefa, e alguns que não se voluntariaram.
-- 
2.43.0

Re: [PATCH v3] docs: translations: pt_BR: translate stable-kernel-rules.rst

[Jonathan Corbet]

Fabio Pereira da Silva <silvapfabio@gmail.com> writes:

> Translate stable-kernel-rules.rst into Brazilian Portuguese and add it
> to the pt_BR process documentation index.
>
> Signed-off-by: Fabio Pereira da Silva <silvapfabio@gmail.com>
> ---
> Changes in v3:
> - Remove Assisted-by trailer.

Why?

In any case, please slow down and take some time between posts.  Others
have to keep up with this stuff...

jon