From: Daniel Pereira <danielmaraboo@gmail.com>
To: corbet@lwn.net, linux-doc@vger.kernel.org
Subject: [PATCH 03/11] docs/translations/pt_BR: process: security-bugs.rst: sync with English
Date: Sat, 24 Oct 2026 10:21:50 -0300 [thread overview]
Message-ID: <20261024132158.39493-4-danielmaraboo@gmail.com> (raw)
In-Reply-To: <20261024132158.39493-1-danielmaraboo@gmail.com>
Sync with the English version:
- the report must give the affected kernel version range using a stable
identifier (commit ID or exact version); time-dependent versions and
distro kernel versions are not accepted;
- add the closing part of the "Responsible use of AI to find bugs"
section, with the minimum procedure an AI assistant must follow and
the two mandatory report steps.
Also fix the "reproducer" labels, translated as a verb and as a word
that does not exist in Portuguese, restore the "instead" that was
dropped and the bold emphasis lost in four places.
Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
.../pt_BR/process/security-bugs.rst | 53 ++++++++++++++-----
1 file changed, 41 insertions(+), 12 deletions(-)
diff --git a/Documentation/translations/pt_BR/process/security-bugs.rst b/Documentation/translations/pt_BR/process/security-bugs.rst
index 321575657..dac456f6e 100644
--- a/Documentation/translations/pt_BR/process/security-bugs.rst
+++ b/Documentation/translations/pt_BR/process/security-bugs.rst
@@ -20,8 +20,13 @@ você não tiver certeza sobre quais informações são úteis. As seguintes
informações são absolutamente necessárias em **qualquer** relatório de falha de
segurança:
- * **versão do kernel afetada**: sem indicação de versão, seu relatório não
- será processado. Uma parte significativa dos relatórios é de bugs que já
+ * **intervalo de versões do kernel afetadas**: sem indicação de versão, seu
+ relatório não será processado. Observe que uma versão dependente do tempo,
+ como "o mainline mais recente", não é aceitável. É necessário um
+ identificador estável, como o ID de um commit ou uma versão exata. Versões
+ que designam kernels que não vêm do kernel.org (como kernels de
+ distribuições) não têm significado para os mantenedores e não serão
+ processadas. Uma parte significativa dos relatórios é de bugs que já
foram corrigidos, portanto, é extremamente importante que as
vulnerabilidades sejam verificadas em versões recentes (árvore de
desenvolvimento ou a versão estável mais recente), pelo menos verificando
@@ -31,7 +36,7 @@ segurança:
mostrando sua manifestação, e por que você considera o comportamento
observado como um problema no Kernel, é necessária.
- * **reproduzir**: os desenvolvedores precisarão ser capazes de reproduzir o
+ * **reprodutor**: os desenvolvedores precisarão ser capazes de reproduzir o
problema para considerar uma correção como eficaz. Isso inclui tanto uma
maneira de acionar o problema quanto uma maneira de confirmar que ele
ocorre. Será necessário um reprodutor com dependências de baixa
@@ -87,7 +92,7 @@ apenas bugs comuns que foram qualificados incorretamente como bugs de segurança
devido à falta de conhecimento do modelo de ameaças do kernel Linux, conforme
descrito em Documentation/process/threat-model.rst, e deveriam ter sido
enviados através dos canais normais descritos em
-Documentation/admin-guide/reporting-issues.rst
+Documentation/admin-guide/reporting-issues.rst, em vez disso.
A lista de segurança existe para bugs urgentes que concedem a um atacante uma
capacidade que ele não deveria ter em um sistema de produção corretamente
@@ -175,7 +180,7 @@ ou este para a lista mais ampla::
dev1@example.com, dev2@example.org, dev3@example.com, dev4@example.org
Se a esta altura você ainda estiver enfrentando dificuldades para identificar
-os mantenedores corretos, e apenas neste caso, é possível enviar seu
+os mantenedores corretos, **e apenas neste caso**, é possível enviar seu
relatório apenas para a equipe de segurança do kernel Linux. Sua mensagem
será triada e você receberá instruções sobre quem contatar, se necessário.
Sua mensagem poderá igualmente ser encaminhada como está para os mantenedores
@@ -203,8 +208,8 @@ a tornar esses relatórios desnecessariamente difíceis de lidar:
* **Formatação**: A maioria dos relatórios gerados por IA está repleta de
tags Markdown. Essas decorações complicam a busca por informações
importantes e não sobrevivem aos processos de citação envolvidos no
- encaminhamento ou nas respostas. Por favor, sempre converta seu relatório
- para texto simples sem quaisquer decorações de formatação antes de
+ encaminhamento ou nas respostas. Por favor, **sempre converta seu relatório
+ para texto simples** sem quaisquer decorações de formatação antes de
enviá-lo.
* **Avaliação de Impacto**: Muitos relatórios gerados por IA carecem de uma
@@ -216,17 +221,17 @@ a tornar esses relatórios desnecessariamente difíceis de lidar:
especulativas. Faça com que sua ferramenta leia esta documentação como
parte do processo de avaliação.
- * **Reproduzidor**: As ferramentas baseadas em IA são frequentemente capazes
- de gerar reproduzidores. Por favor, certifique-se sempre de que sua
- ferramenta forneça um e teste-o exaustivamente. Se o reproduzidor não
+ * **Reprodutor**: As ferramentas baseadas em IA são frequentemente capazes
+ de gerar reprodutores. Por favor, certifique-se sempre de que sua
+ ferramenta forneça um e **teste-o exaustivamente**. Se o reprodutor não
funcionar, ou se a ferramenta não puder produzir um, a validade do
relatório deve ser seriamente questionada. Observe que, como o relatório
- será postado em uma lista pública, o reproduzidor só deve ser compartilhado
+ será postado em uma lista pública, o reprodutor só deve ser compartilhado
mediante solicitação dos mantenedores.
* **Propor uma Correção:** muitas ferramentas de IA são na verdade melhores
em escrever código do que em avaliá-lo. Por favor, peça à sua ferramenta
- para propor uma correção e teste-a antes de relatar o problema.
+ para propor uma correção e **teste-a** antes de relatar o problema.
Se a correção não puder ser testada porque depende de hardware raro ou de
protocolos de rede quase extintos, é provável que o problema não seja um
bug de segurança. Em qualquer caso, se uma correção for proposta, ela deve
@@ -245,6 +250,30 @@ um mantenedor com um relatório sem importância. Se o problema for claramente
trivial e publicamente detectável, você deve relatá-lo diretamente às listas
de discussão públicas.
+No mínimo, ao usar um assistente de IA para encontrar e relatar bugs, faça com
+que o assistente leia este arquivo e o Documentation/process/threat-model.rst
+antes de prosseguir, e que ele siga o procedimento descrito em
+coding-assistants.rst: trabalhar em uma árvore mainline atualizada e anotar o
+ID do commit, verificar se o bug é real, escrever uma correção, compilá-la sem
+avisos e sem apontamentos do checkpatch, fazer o commit com uma tag Fixes e
+identificar os mantenedores com o get_maintainer.pl.
+
+Além desse procedimento, o assistente de IA **DEVE**:
+
+1. Preparar um relatório em texto simples explicando o problema. Ele deve
+ conter os quatro itens listados no topo deste arquivo como absolutamente
+ necessários: a versão afetada ou o ID do commit anotado ao seguir o
+ procedimento acima, a descrição do problema, o reprodutor ou o seu status,
+ e as condições de acionamento.
+2. Iniciar o relatório com uma seção temporária listando os endereços dos
+ destinatários (mantenedores+lista para o patch, apenas mantenedores para o
+ relatório e o reprodutor), e com instruções lembrando o relator de verificar
+ se o seu cliente de e-mail está configurado corretamente (veja
+ email-clients.rst), e deixar a cargo do relator a remoção dessa seção
+ temporária.
+
+Um processo mais detalhado é descrito em https://github.com/masoncl/kres.git.
+
Enviando o relatório
--------------------
--
2.47.3
next prev parent reply other threads:[~2026-10-24 13:22 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-10-24 13:21 [PATCH 00/11] docs/translations/pt_BR: process: sync with English and fix errors Daniel Pereira
2026-10-24 13:21 ` [PATCH 01/11] docs/translations/pt_BR: process: fix 1.Intro.rst and add labels Daniel Pereira
2026-10-24 13:21 ` [PATCH 02/11] docs/translations/pt_BR: process: coding-assistants.rst: add bug procedure Daniel Pereira
2026-10-24 13:21 ` Daniel Pereira [this message]
2026-10-24 13:21 ` [PATCH 04/11] docs/translations/pt_BR: process: maintainer-netdev.rst: sync with English Daniel Pereira
2026-10-24 13:21 ` [PATCH 05/11] docs/translations/pt_BR: process: maintainer-soc.rst: " Daniel Pereira
2026-10-24 13:21 ` [PATCH 06/11] docs/translations/pt_BR: process: changes.rst: " Daniel Pereira
2026-10-24 13:21 ` [PATCH 07/11] docs/translations/pt_BR: process: license-rules.rst: fix lists and table Daniel Pereira
2026-10-24 13:21 ` [PATCH 08/11] docs/translations/pt_BR: process: 2.Process.rst: fix translation errors Daniel Pereira
2026-10-24 13:21 ` [PATCH 09/11] docs/translations/pt_BR: process: fix cross-references and list markup Daniel Pereira
2026-10-24 13:21 ` [PATCH 10/11] docs/translations/pt_BR: process: restore links, emphasis and headings Daniel Pereira
2026-10-24 13:21 ` [PATCH 11/11] docs/translations/pt_BR: process: fix kernel-docs and enforcement statement Daniel Pereira
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=20261024132158.39493-4-danielmaraboo@gmail.com \
--to=danielmaraboo@gmail.com \
--cc=corbet@lwn.net \
--cc=linux-doc@vger.kernel.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