Linux Documentation
 help / color / mirror / Atom feed
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


  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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox