[PATCH v2] docs: translations: pt_BR: translate generated-content.rst

[PATCH v2] docs: translations: pt_BR: translate generated-content.rst

[Ygor Otavio]

Translate generated-content.rst into Brazilian Portuguese,
maintaining consistency with original formatting rules.
Add it to the pt_BR process documentation index.
And fixed the errors in the commit.

Assisted-by:LLM

Signed-off-by: Ygor Otavio <ygorotavio.sjc@gmail.com>

---
---
 .../pt_BR/process/generated-content.rst       | 117 ++++++++++++++++++
 .../translations/pt_BR/process/index.rst      |   1 +
 2 files changed, 118 insertions(+)
 create mode 100644 Documentation/translations/pt_BR/process/generated-content.rst

diff --git a/Documentation/translations/pt_BR/process/generated-content.rst b/Documentation/translations/pt_BR/process/generated-content.rst
new file mode 100644
index 000000000000..1c66dd9c13a5
--- /dev/null
+++ b/Documentation/translations/pt_BR/process/generated-content.rst
@@ -0,0 +1,117 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+=========================================================
+Diretrizes do Kernel para Conteúdo Gerado por Ferramentas
+=========================================================
+
+Propósito
+=========
+
+Os contribuidores do kernel vêm usando ferramentas para gerar contribuições há
+muito tempo. Essas ferramentas podem aumentar o volume de contribuições. Ao mesmo
+tempo, o tempo disponível de revisores e mantenedores é um recurso escasso.
+Entender quais partes de uma contribuição vêm de humanos e quais vêm de ferramentas
+ajuda a preservar esses recursos e manter o desenvolvimento do kernel saudável.
+
+O objetivo aqui é esclarecer as expectativas da comunidade em relação a ferramentas.
+Isso permite que todos se tornem mais produtivos, mantendo ao mesmo tempo um alto
+grau de confiança entre submetedores e revisores.
+
+Fora do Escopo
+===============
+
+Estas diretrizes não se aplicam a ferramentas que fazem ajustes triviais em
+conteúdo preexistente. Também não dizem respeito a ferramentas que ajudam em
+tarefas menores. Alguns exemplos:
+
+ - Correções de ortografia e gramática, como reformular para o modo imperativo
+ - Auxílios de digitação como completar identificadores, boilerplate
+   ou completar padrões triviais
+ - Transformações puramente mecânicas, como renomear variáveis
+ - Reformatação, como executar o Lindent, ``clang-format`` ou ``rust-fmt``
+
+Mesmo quando o uso da sua ferramenta estiver fora do escopo, você
+ainda deve sempre considerar se informar ao revisor qual ferramenta
+você usou ajudaria na revisão da sua contribuição.
+
+No Escopo
+==========
+
+Estas diretrizes se aplicam quando uma quantidade significativa de conteúdo em
+uma contribuição do kernel não foi escrita por uma pessoa presente na cadeia de
+Signed-off-by, mas sim criada por uma ferramenta.
+
+A detecção de um problema e o teste da correção para ele também fazem parte do
+processo de desenvolvimento; se uma ferramenta foi usada para encontrar um problema
+tratado por uma alteração, isso deve ser mencionado no changelog. Isso não apenas
+dá o devido crédito, como também ajuda outros desenvolvedores a descobrir essas
+ferramentas.
+
+Alguns exemplos:
+ - Qualquer correção sugerida por ferramenta, como ``checkpatch.pl --fix``
+ - Scripts do Coccinelle
+ - Um chatbot gerou uma nova função no seu patch para ordenar entradas de lista.
+ - Um arquivo .c do patch foi originalmente gerado por um assistente de codificação,
+   mas foi limpo manualmente.
+ - O changelog foi gerado entregando o patch a uma ferramenta de IA generativa e
+   pedindo que ela escrevesse o changelog.
+ - O changelog foi traduzido de outro idioma.
+
+Em caso de dúvida, escolha a transparência e presuma que estas diretrizes se
+aplicam à sua contribuição.
+
+Diretrizes
+==========
+
+Primeiro, leia o Developer's Certificate of Origin:
+Documentation/process/submitting-patches.rst. Suas regras são simples e estão em
+vigor há muito tempo. Elas já cobriram diversas contribuições geradas por ferramentas.
+Certifique-se de que você entende toda a sua submissão e está preparado para
+responder aos comentários de revisão.
+
+Segundo, ao fazer uma contribuição, seja transparente sobre a origem
+do conteúdo em cover letters e changelogs. Você pode ser mais
+transparente adicionando informações como:
+
+ - Quais ferramentas foram usadas?
+ - A entrada fornecida às ferramentas que você usou, como o script de origem do
+   Coccinelle.
+ - Se o código foi majoritariamente gerado a partir de um único prompt ou um
+   pequeno conjunto de prompts, inclua esses prompts. Para sessões mais longas,
+   inclua um resumo dos prompts e da natureza da assistência resultante.
+ - Quais partes do conteúdo foram afetadas por essa ferramenta?
+ - Como a submissão foi testada e quais ferramentas foram usadas para testar a
+   correção?
+
+Como em todas as contribuições, cada mantenedor tem a discricionariedade de escolher
+como lidar com a contribuição. Por exemplo, eles podem:
+
+ - Tratá-la como qualquer outra contribuição.
+ - Rejeitá-la de imediato.
+ - Tratar a contribuição de forma especial, por exemplo, pedindo testes extras,
+   revisando com escrutínio adicional, ou revisando com prioridade menor do que
+   conteúdo gerado por humanos.
+ - Pedir algum outro passo especial, como solicitar que o contribuidor detalhe
+   como a ferramenta ou o modelo foi treinado.
+ - Pedir ao submetedor que explique em mais detalhes sobre a contribuição, para
+   que o mantenedor possa se assegurar de que o submetedor entende completamente
+   como o código funciona.
+ - Sugerir um prompt melhor em vez de sugerir alterações específicas de código.
+
+Se as ferramentas permitirem que você gere uma contribuição automaticamente,
+espere escrutínio adicional proporcional a quanto dela foi gerado.
+
+Como com a saída de qualquer ferramenta, o resultado pode estar incorreto ou
+inadequado. Espera-se que você entenda e seja capaz de defender tudo o que submeter.
+Se você não for capaz de fazer isso, então não submeta as alterações resultantes.
+
+Se você o fizer mesmo assim, os mantenedores têm o direito de rejeitar sua série
+sem revisão detalhada.
+
+Referências
+============
+
+Para diretrizes específicas sobre assistentes de codificação de IA, veja:
+
+
+* Documentation/process/coding-assistants.rst
diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst
index eda2a3fc5166..cced028e12c9 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
    Modelos de Maturidade para Contribuição no Kernel Linux <contribution-maturity-model.rst>
    Declaração sobre Drivers do Kernel <kernel-driver-statement>
    Estilo de gerenciamento do kernel Linux <management-style>
+   Diretrizes do Kernel para Conteúdo Gerado por Ferramentas <generated-content>
    Conclave (Continuidade do projeto) <conclave>
 
 Lidando com bugs
-- 
2.55.0

Re: [PATCH v2] docs: translations: pt_BR: translate generated-content.rst

[Daniel Pereira]

Hi Ygor,

    Thanks for the patch and for working on this translation!
    The translation captures the intent well, but please see a few
  comments inline:

    > Subject: [PATCH v2] docs: translations: pt_BR: translate
  generated-content.rst

    Please include the subdirectory: "docs: pt_BR: translate
  process/generated-content.rst"

    > And fixed the errors in the commit.

    Changelogs (v1 -> v2) should go below the '---' cutline, not in
  the commit message.
    Also, consider adding: "Update the translation through commit
  <hash> ("<subject>")"

    > Assisted-by:LLM
    >
    > Signed-off-by: Ygor Otavio <ygorotavio.sjc@gmail.com>

    Add a space ("Assisted-by: LLM") and remove the blank line between
  trailers.

    > ---
    > ---

    Note the duplicated '---' line here.

    > +=========================================================
    > +Diretrizes do Kernel para Conteúdo Gerado por Ferramentas
    > +=========================================================

    Please wrap text at 80 columns; 11 lines currently exceed the
  limit (11, 13, 16,
    17, 45, 46, 54, 68, 86, 105, 106).

    > +tempo, o tempo disponível de revisores e mantenedores é um
  recurso escasso.

    Avoid repeating "tempo": "Ao mesmo tempo, a disponibilidade de
  revisores..."

    > +grau de confiança entre submetedores e revisores.

    Avoid the calque "submetedor" throughout; use "autor",
  "contribuidor", or "quem submete".

    > +Fora do Escopo
    > +===============

    Match underline length to title length (14 '=' instead of 15).
    Also applies to "No Escopo" (9 '=') and "Referências" (11 '=').

    > + - Auxílios de digitação como completar identificadores,
  boilerplate

    Add comma ("Auxílios de digitação, como...") and translate
  "common" ("boilerplate comum").

    > +Mesmo quando o uso da sua ferramenta estiver fora do escopo,
  você
    > +ainda deve sempre considerar se informar ao revisor qual
  ferramenta
    > +você usou ajudaria na revisão da sua contribuição.

    A bit clunky; suggest:
    "Mesmo quando o uso de ferramentas estiver fora do escopo,
  considere sempre
    se informar ao revisor a ferramenta utilizada ajudaria na revisão
  da sua contribuição."

    > +Como em todas as contribuições, cada mantenedor tem a
  discricionariedade de escolher

    Redundant; suggest: "tem a discricionariedade de decidir como
  lidar" or "tem autonomia".

    > + - Pedir ao submetedor que explique em mais detalhes sobre a
  contribuição, para
    > +   que o mantenedor possa se assegurar de que o submetedor
  entende completamente

    Avoid repeating "submetedor" twice, and fix verb regimen:
    "Pedir ao autor que explique a contribuição em mais detalhes..."

    > +espere escrutínio adicional proporcional a quanto dela foi
  gerado.

    Missing article: "proporcional ao quanto dela foi gerado".

    > +Como com a saída de qualquer ferramenta, o resultado pode estar
  incorreto ou

    Awkward cacophony; suggest: "Assim como ocorre com a saída de
  qualquer ferramenta,".

    > +Para diretrizes específicas sobre assistentes de codificação de
    > IA, veja:
    > +
    > +
    > +* Documentation/process/coding-assistants.rst

    Remove the extra blank line before the bullet.

    > +   Diretrizes do Kernel para Conteúdo Gerado por Ferramentas
  <generated-content>
    >     Conclave (Continuidade do projeto) <conclave>

    In pt_BR/process/index.rst, please place this right before
  'coding-assistants'
    to match the English index order.

    Looking forward to v3!

    Thanks,
    Daniel