From: Lucas Adryell Ramalho <lucasadramalho@gmail.com>
To: Daniel Pereira <danielmaraboo@gmail.com>,
Jonathan Corbet <corbet@lwn.net>
Cc: Shuah Khan <skhan@linuxfoundation.org>,
Randy Dunlap <rdunlap@infradead.org>,
linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
Lucas Adryell Ramalho <lucasadramalho@gmail.com>
Subject: [PATCH v1 3/3] docs: translations: pt_BR: Translate stable-kernel-rules.rst
Date: Tue, 13 Oct 2026 20:45:44 -0300 [thread overview]
Message-ID: <ee88fc5b7ff27dd1325b8a80414615d300b1558d.1791933697.git.lucasadramalho@gmail.com> (raw)
In-Reply-To: <cover.1791933697.git.lucasadramalho@gmail.com>
Translate the stable kernel rules documentation into Brazilian Portuguese.
Signed-off-by: Lucas Adryell Ramalho <lucasadramalho@gmail.com>
---
.../translations/pt_BR/process/index.rst | 1 +
.../pt_BR/process/stable-kernel-rules.rst | 258 ++++++++++++++++++
2 files changed, 259 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 31704e28d..29f6c7735 100644
--- a/Documentation/translations/pt_BR/process/index.rst
+++ b/Documentation/translations/pt_BR/process/index.rst
@@ -63,6 +63,7 @@ Estas são as regras pelas quais tentamos viver na comunidade do kernel
Declaração de Aplicação do Kernel Linux <kernel-enforcement-statement>
Declaração sobre Drivers do Kernel <kernel-driver-statement>
A interface de drivers do kernel Linux <stable-api-nonsense>
+ Tudo o que você sempre quis saber sobre as versões estáveis do Linux <stable-kernel-rules>
Estilo de gerenciamento do kernel Linux <management-style>
Diretrizes para pesquisadores <researcher-guidelines>
Assistentes de código <coding-assistants>
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 000000000..103108be4
--- /dev/null
+++ b/Documentation/translations/pt_BR/process/stable-kernel-rules.rst
@@ -0,0 +1,258 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. _pt_BR_stable_kernel_rules:
+
+Tudo o que você sempre quis saber sobre as versões estáveis do Linux
+====================================================================
+
+Regras sobre quais tipos de correções são aceitos na árvore "-stable" e
+quais não são:
+
+- A correção, ou uma equivalente, já deve existir na linha principal do
+ Linux (upstream).
+- Deve estar obviamente correta e ter sido testada.
+- Não pode ter mais de 100 linhas, incluindo o contexto.
+- Deve seguir as regras de
+ :ref:`Documentation/translations/pt_BR/process/submitting-patches.rst
+ <submittingpatches>`.
+- Deve corrigir um erro real que afete as pessoas ou apenas adicionar um ID
+ de dispositivo. Em mais detalhes, o primeiro caso inclui:
+
+ - Corrigir um problema como um oops, travamento, corrupção de dados,
+ problema real de segurança, peculiaridade de hardware, erro de
+ compilação (exceto itens CONFIG_BROKEN) ou algum problema do tipo "isso
+ não é nada bom".
+ - Problemas graves relatados por usuários de um kernel de distribuição
+ também podem ser considerados se as correções resolverem um problema
+ notável de desempenho ou interatividade. Como essas correções não são
+ tão óbvias e apresentam maior risco de causar uma regressão sutil, elas
+ só devem ser enviadas pelo mantenedor do kernel da distribuição e
+ devem incluir um complemento com um link para uma entrada no Bugzilla,
+ se houver, e informações adicionais sobre o impacto percebido pelo
+ usuário.
+ - Não são aceitos problemas do tipo "isto pode ser um problema...", como
+ uma "condição de corrida teórica", a menos que também seja fornecida
+ uma explicação de como o erro pode ser explorado.
+ - Não são aceitas correções "triviais" sem benefício para os usuários
+ (alterações ortográficas, limpeza de espaços em branco etc.).
+
+
+Procedimento para enviar correções à árvore -stable
+----------------------------------------------------
+
+.. note::
+
+ Correções de segurança não devem ser tratadas exclusivamente pelo
+ processo de revisão -stable; devem seguir os procedimentos em
+ :ref:`Documentation/translations/pt_BR/process/security-bugs.rst
+ <securitybugs>`.
+
+Há três opções para enviar uma alteração às árvores -stable:
+
+1. Adicionar uma "stable tag" à descrição de uma correção que será enviada
+ para inclusão na linha principal.
+2. Pedir à equipe stable que inclua uma correção já integrada à linha
+ principal.
+3. Enviar à equipe stable uma correção equivalente a uma alteração já
+ integrada à linha principal.
+
+As seções abaixo descrevem cada opção em mais detalhes.
+
+A :ref:`pt_BR_option_1` é **fortemente** preferida; é a opção mais fácil e
+mais comum.
+A :ref:`pt_BR_option_2` destina-se principalmente a alterações para as
+quais o backport não foi considerado no momento do envio.
+A :ref:`pt_BR_option_3` é uma alternativa às opções anteriores quando uma
+correção integrada à linha principal precisa de ajustes para ser aplicada
+a séries mais antigas (por exemplo, devido a alterações na 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. Nesse caso, certifique-se de que a correção ou
+uma equivalente seja aplicável, tenha sido enviada ou já esteja presente em
+todas as árvores stable mais novas que ainda recebem suporte. Isso evita
+regressões que os usuários poderiam encontrar ao atualizar. Por exemplo,
+uma correção integrada para 5.19-rc1 poderia ser portada para
+5.10.y, mas não para 5.15.y.
+
+.. _pt_BR_option_1:
+
+Opção 1
+*******
+
+Para que uma correção enviada para inclusão na linha principal seja
+selecionada automaticamente depois pelas árvores stable, adicione esta
+etiqueta à seção de assinaturas (sign-off)::
+
+ Cc: stable@vger.kernel.org
+
+Use ``Cc: stable@kernel.org`` em vez disso ao corrigir vulnerabilidades
+ainda não divulgadas: isso reduz a chance de expor acidentalmente a
+correção ao público por meio do 'git send-email', pois as mensagens
+enviadas a esse endereço não são entregues.
+
+Depois que a correção for integrada à linha principal, ela será aplicada à
+árvore stable sem que o autor ou o mantenedor do subsistema precise fazer
+mais nada.
+
+Para enviar instruções adicionais à equipe stable, use um comentário em
+linha no estilo do shell para passar observações arbitrárias ou
+predefinidas:
+
+* Especifique pré-requisitos adicionais para a seleção por cherry-pick::
+
+ 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 etiquetas indica que se deve executar::
+
+ git cherry-pick a1f84a3
+ git cherry-pick 1b9508f
+ git cherry-pick fd21073
+ git cherry-pick <this commit>
+
+ Observe que, em uma série de correções, não é necessário listar como
+ pré-requisitos as correções que fazem parte da própria série. Por
+ exemplo, nesta série::
+
+ patch1
+ patch2
+
+ patch2 depende de patch1, mas não é necessário listar patch1 como
+ pré-requisito de patch2 se você já tiver marcado patch1 para inclusão no
+ stable.
+
+* Indique os pré-requisitos de versão do kernel::
+
+ Cc: <stable@vger.kernel.org> # 3.3.x
+
+ A etiqueta indica que se deve executar::
+
+ git cherry-pick <this commit>
+
+ em cada árvore -stable a partir da versão especificada.
+
+ Observe que essa etiqueta é desnecessária se a equipe stable puder
+ deduzir as versões apropriadas a partir das etiquetas Fixes:.
+
+* Adiar a inclusão de correções::
+
+ Cc: <stable@vger.kernel.org> # after -rc3
+
+* Aponte problemas conhecidos::
+
+ Cc: <stable@vger.kernel.org> # see patch description, needs adjustments for <= 6.3
+
+Também há uma variante da etiqueta stable que pode ser usada para fazer com
+que as ferramentas de backport da equipe stable (por exemplo, AUTOSEL ou
+scripts que procuram commits com uma etiqueta 'Fixes:') ignorem uma
+alteração::
+
+ Cc: <stable+noautosel@kernel.org> # reason goes here, and must be present
+
+.. _pt_BR_option_2:
+
+Opção 2
+*******
+
+Se a correção já tiver sido integrada à linha principal, envie um e-mail
+para stable@vger.kernel.org com o assunto da correção, o ID do commit, o
+motivo pelo qual você acredita que ela deve ser aplicada e as versões do
+kernel às quais deve ser aplicada.
+
+.. _pt_BR_option_3:
+
+Opção 3
+*******
+
+Depois de verificar que a correção segue as regras acima, envie-a para
+stable@vger.kernel.org e indique as versões do kernel às quais deseja que
+ela seja aplicada. Nesse caso, você deve indicar o ID do commit upstream no
+registro de alterações do envio, em uma linha separada acima do texto do
+commit, assim::
+
+ commit <sha1> upstream.
+
+Ou, alternativamente::
+
+ [ Upstream commit <sha1> ]
+
+Se a correção enviada diferir da correção upstream original (por exemplo,
+porque precisou ser adaptada à API mais antiga), isso deve ser documentado
+e justificado com muita clareza na descrição da correção.
+
+
+Acompanhamento do envio
+-----------------------
+
+O remetente receberá um ACK quando a correção for aceita na fila, ou um NAK
+se for rejeitada. Essa resposta pode levar alguns dias, dependendo da
+disponibilidade dos membros da equipe stable.
+
+Se for aceita, a correção será adicionada à fila -stable para revisão por
+outros desenvolvedores e pelo mantenedor do subsistema relevante.
+
+
+Ciclo de revisão
+----------------
+
+- Quando os mantenedores -stable decidirem iniciar um ciclo de revisão, as
+ correções serão enviadas ao comitê de revisão, ao mantenedor da área
+ afetada pela correção (a menos que o remetente seja o mantenedor dessa
+ área) e em cópia (CC:) para a lista de discussão linux-kernel.
+- O comitê de revisão tem 48 horas para aprovar (ACK) ou rejeitar (NAK) a
+ correção.
+- Se um membro do comitê rejeitar a correção ou membros da lista
+ linux-kernel apresentarem objeções levantando problemas que os
+ mantenedores e os membros não perceberam, a correção será removida da
+ fila.
+- As correções aprovadas serão publicadas novamente como parte de uma
+ versão candidata (-rc), para serem testadas por desenvolvedores e
+ testadores.
+- Geralmente é publicada apenas uma versão -rc. No entanto, se houver
+ problemas pendentes, algumas correções poderão ser modificadas ou
+ removidas, ou outras poderão ser adicionadas à fila. Nesse caso, versões
+ -rc adicionais serão publicadas e testadas até que nenhum problema seja
+ encontrado.
+- É possível responder às versões -rc na lista de discussão enviando um
+ e-mail "Tested-by:" com as informações de teste desejadas. As etiquetas
+ "Tested-by:" serão reunidas e adicionadas ao commit de lançamento.
+- Ao final do ciclo de revisão, a nova versão -stable será lançada com
+ todas as correções enfileiradas e testadas.
+- Correções de segurança serão aceitas diretamente na árvore -stable pela
+ equipe de segurança do kernel e não passarão pelo ciclo normal de
+ revisão. Entre em contato com a equipe de segurança do kernel para saber
+ mais sobre esse procedimento.
+
+
+Árvores
+-------
+
+- As filas de correções, tanto das versões concluídas quanto das versões em
+ andamento, podem ser encontradas em:
+
+ https://git.kernel.org/pub/scm/linux/kernel/git/stable/stable-queue.git
+
+- As versões finalizadas e identificadas por tags de todos os kernels
+ estáveis podem ser encontradas em ramificações separadas por versão em:
+
+ https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
+
+- As versões candidatas de todas as versões do kernel stable podem ser
+ encontradas em:
+
+ https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable-rc.git/
+
+ .. warning::
+ A árvore -stable-rc é um instantâneo da árvore stable-queue e muda com
+ frequência; por isso, é rebaseada frequentemente. Ela deve ser usada
+ apenas para testes (por exemplo, por sistemas de integração contínua).
+
+
+Comitê de revisão
+-----------------
+
+- É formado por vários desenvolvedores do kernel que se voluntariaram para
+ essa tarefa e por alguns que não se voluntariaram.
--
2.55.0
prev parent reply other threads:[~2026-10-13 23:46 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-10-13 23:45 [PATCH v1 0/3] docs: translations: pt_BR: Add process documentation Lucas Adryell Ramalho
2026-10-13 23:45 ` [PATCH v1 1/3] docs: translations: pt_BR: process: add driver_development_debugging_guide Lucas Adryell Ramalho
2026-10-13 23:45 ` [PATCH v1 2/3] docs: translations: pt_BR: process: Translate researcher-guidelines.rst Lucas Adryell Ramalho
2026-10-13 23:45 ` Lucas Adryell Ramalho [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=ee88fc5b7ff27dd1325b8a80414615d300b1558d.1791933697.git.lucasadramalho@gmail.com \
--to=lucasadramalho@gmail.com \
--cc=corbet@lwn.net \
--cc=danielmaraboo@gmail.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=rdunlap@infradead.org \
--cc=skhan@linuxfoundation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®