From: Daniel Pereira <danielmaraboo@gmail.com>
To: corbet@lwn.net, linux-doc@vger.kernel.org
Subject: [PATCH 02/11] docs/translations/pt_BR: process: coding-assistants.rst: add bug procedure
Date: Sat, 24 Oct 2026 10:21:49 -0300 [thread overview]
Message-ID: <20261024132158.39493-3-danielmaraboo@gmail.com> (raw)
In-Reply-To: <20261024132158.39493-1-danielmaraboo@gmail.com>
Sync with the English version: translate the new "Procedure for
finding and fixing bugs" section, which lists the steps an AI assistant
must follow when finding and fixing bugs.
Also fix two translation errors: "GPL-2.0-only" is the license
identifier, not "only GPL-2.0", and the generated-content.rst pointer is
about guidelines on content generated by AI assistants, not only about
code.
Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
.../pt_BR/process/coding-assistants.rst | 45 ++++++++++++++++++-
1 file changed, 43 insertions(+), 2 deletions(-)
diff --git a/Documentation/translations/pt_BR/process/coding-assistants.rst b/Documentation/translations/pt_BR/process/coding-assistants.rst
index f6062b22a..906dc880e 100644
--- a/Documentation/translations/pt_BR/process/coding-assistants.rst
+++ b/Documentation/translations/pt_BR/process/coding-assistants.rst
@@ -13,7 +13,7 @@ padrões de desenvolvimento do kernel:
* Documentation/process/coding-style.rst
* Documentation/process/submitting-patches.rst
-Para guias e conteúdo sobre códigos gerados por assistentes de IA veja:
+Para diretrizes sobre conteúdo gerado por assistentes de IA, veja:
* Documentation/process/generated-content.rst
@@ -23,7 +23,7 @@ Licenças e Requisitos Legais
Todas as contribuições devem estar de acordo com os requisitos de licença do
kernel:
-* Todo código deve ser compatível apenas com GPL-2.0
+* Todo código deve ser compatível com GPL-2.0-only
* Use identificadores SPDX de licença apropriados
* Veja Documentation/process/license-rules.rst para mais detalhes
@@ -38,3 +38,44 @@ A pessoa que envia é responsável por:
* Garantir conformidade com os requisitos de licença
* Acrescentar sua própria tag Signed-off-by para certificar o DCO
* Assumir toda responsabilidade pela contribuição
+
+Procedimento para encontrar e corrigir bugs
+===========================================
+
+Quando um assistente de IA é usado para encontrar e corrigir bugs, ele **DEVE**
+seguir pelo menos estes passos:
+
+1. Antes de começar, leia toda a documentação do processo listada acima, bem
+ como qualquer outro documento mencionado na solicitação. Não confie em
+ trechos isolados encontrados por busca de palavras-chave.
+2. Anote o ID do commit e localize um bug conforme instruído.
+3. Para qualquer bug encontrado que não seja trivial, verifique se ele parece
+ real tentando criar um reprodutor que o demonstre. A falta dele pode fazer
+ com que o relatório seja ignorado, já que muitos relatórios de bugs não
+ verificados enviados aos mantenedores acabam sendo inválidos. Pare aqui se,
+ no fim, ele parecer equivocado.
+4. Escreva uma correção para o bug. Esta parte não é opcional: exceto em
+ alguns poucos casos muito raros, um assistente de IA capaz de encontrar um
+ bug é capaz de corrigi-lo. Note que correções escritas na mesma sessão
+ usada para encontrar o bug geralmente resultam em correções melhores e mais
+ precisas, pois o contexto de raciocínio do LLM continua presente.
+5. Compile e verifique se a correção funciona, usando o reprodutor ou
+ executando novamente uma análise completa; descarte qualquer correção que
+ não funcione e tente outra. A correção não deve adicionar avisos de
+ compilação e deve passar nas verificações do checkpatch.pl (veja
+ submitting-patches.rst).
+6. Faça o commit da correção que funciona com uma mensagem detalhada
+ descrevendo o problema, a solução e uma tag Fixes. Não adicione uma tag
+ Signed-off-by.
+7. Identifique os mantenedores e as listas usando scripts/get_maintainer.pl.
+ Documentation/process/security-bugs.rst mostra como fazer isso.
+8. Indique o que não pôde ser feito. Se a correção não pôde ser compilada ou
+ testada, ou se não foi possível produzir um reprodutor, diga isso
+ explicitamente: atualmente os mantenedores perdem tempo demais analisando
+ relatórios não verificados e correções não testadas.
+9. Leia Documentation/process/threat-model.rst para determinar se o bug é uma
+ vulnerabilidade ou um bug comum, e deixe o resultado para a revisão do
+ relator (o assistente nunca deve enviar nada por conta própria). Bugs
+ comuns são enviados conforme descrito em
+ Documentation/process/submitting-patches.rst, e vulnerabilidades conforme
+ descrito em Documentation/process/security-bugs.rst.
--
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 ` Daniel Pereira [this message]
2026-10-24 13:21 ` [PATCH 03/11] docs/translations/pt_BR: process: security-bugs.rst: sync with English Daniel Pereira
2026-10-24 13:21 ` [PATCH 04/11] docs/translations/pt_BR: process: maintainer-netdev.rst: " 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-3-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 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.