From nobody Fri Sep 25 06:46:45 2026 Received: from mail-ua2-f15.google.com (mail-ua2-f15.google.com [74.125.226.207]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 260C53563F6 for ; Wed, 16 Sep 2026 02:04:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.226.207 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1789524301; cv=none; b=T+CyIuFc/jTd88Z/cJkGf8SsIuy29/EmRLxsSg8Z4RWxViLgAErEXPzesQ0rd3t2vTJ4c1nKCbiPA2ycqw0LHZXiJB+EwaK7y49ZOSSW2bKYiBjlWjqmw7B3LYFspWfG3TyjtRwr599Lcco223HdqWQYle29kt7Hk7p7vhNYyEM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1789524301; c=relaxed/simple; bh=hKvJ3uZ4Y5+pLwSM/dL05OZ2SqiUT4YYz3BWKGgJMUk=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=njzoRErPjLKN71zxWpHTznhlhJhkF10sgrNr5vtpFucABpYROZgSVgLNkW+hL2IsNCyoZC7h2NMoLp/RTIC1W7Meh/9hGVjmAv4EpzRcPCUaQKNvGndYFopaTDoN63Hx6eBzFZNM1crFVv8f4AKQfrx4DuXMVBD7fAM/2GoSquQ= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=X0yCB+F6; arc=none smtp.client-ip=74.125.226.207 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="X0yCB+F6" Received: by mail-ua2-f15.google.com with SMTP id a1e0cc1a2514c-97e7c7b4ed2so233312241.2 for ; Tue, 15 Sep 2026 19:04:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1789524288; x=1790129088; darn=vger.kernel.org; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to :content-type; bh=g8tHdM1R8QWrfrycXdnSxkZx2URIKhlqCiEDWfYHPL0=; b=X0yCB+F6i3IqZRH4oyMkkTdsIIj/r5LcO0hwtF3rQsX9Rp2vJxFbG9hLF0OeruvQs5 NmWeefGPH1xpVTfwZrT0EfsF44mR9VN2mxY4CY+i1EFplFXkWVU5f5dM0zqTQsoQZxYx aS3ZDI1RX47AbIBZIbCuYW8NX9AqV57zGTof+pP1v6bCxR13UgpkjMixYHT453Vhsv7d xaVr6y2obs3mj94gmfdJk2RTLk5JTBSveKAFQNgB5M2ECyEpqSYPXKGU5Zu5cB6lGq4j ATs9iqiyknc9uE3WwL23Z4w7AfT0elm9WJhdBnEH3/d4TwmA0gPNW/mVsAx8Uhvi/Cnq XAmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1789524288; x=1790129088; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to:content-type; bh=g8tHdM1R8QWrfrycXdnSxkZx2URIKhlqCiEDWfYHPL0=; b=Fy05NhTGh9B3XTiiH0L7Sjq7AduCikZ13+uYB2SQXSs0uHl3JBs5TPpPJiwrNL3gOo IjwaENRrBBMhqHD/PD5zEyaox60tyJrfhirfmd/hIFhObrRsMPnrFQEIurBkeh2gPuXP 5IkqfHQ/wW9RnFwPUnM5tjQ85yRuW9TcnIx7F0oCeztS8ENH0wGYwUnAEmmaKJ4n48mm opd2kjvIfSDLH4RE7MrSHHcGYzx9Zt8TRzwBb5cBDnwIBIwpyA5yGFAtL/dTjBsobGf2 QZJlN6qOA07RUi3iI7weO2PpEc8Il/MFi7IGUtkSp2tTtxTQ6fltdJvvl1F/Jot6/bR/ mk4Q== X-Forwarded-Encrypted: i=1; AKwUvByNwQPI4c2Me3yxw2b6/kNVBRmTX1boEvi7WZNFj9p+9V3lC0/SuuGNxuEZQAKxtRcTFmGhvHE6o2nx2Cs=@vger.kernel.org X-Gm-Message-State: AFuF++nFwKCBpIw3bWQKEYZPGyDxwnVnE7sW6lPbSRPLjnOE+2gI3tXZ 5wxle33q5DbN26UjCelkJM+UUfydHA3f2f2hXGSxzDPFP73omAxrwMJq X-Gm-Gg: AYBFou14QmsGwQzuhXXB2fnoJ+k0AkV0gVpf0v3v3RITWhXOMNz4ZuMjPM2se1cbGx+ VGGOk84Ny1c4AyF9Xd2fND8Gjc/VaU8d8ZW+XR+RENeiPfsWiwNF8ztxVyd9Tu4/oo+nbyH6IBg f8ac9nvD1CD0URzNPNHBt94OlqXElA1kUgL2E9XHIox7KS17HUHIdLSrkOJCxEAdDYER6POUbvm g54kjw2DjYtI8Iw41ncX6Bkz1aGY50ivMtUYm+MlKESyJ6BvndsL6X0FTNu67qqBRfMlBkA94+8 J3fdtycG/82WMeMM+FyFSxMdDWk0MdIO6PX2jo6Osqzvwl/izQvpwW70BNiADvhQ6Xj8LR/CZhv +gbviAjXp6zSNUCMl40u4vSnW5d6U6YLM4yiuv8YvDrJJDF5emdUTIhQfNI/Nuau4d7IjRichyL yZS56Jy/+aPRv5AH1l2dq8Kev8sJciYPRc2JfT6vh2tLV9Ua0MwL1Ai28V+MpjXO2AXfDSxcZae lxjZg6Kf5rD X-Received: by 2002:a05:6102:5812:b0:79e:3401:403a with SMTP id ada2fe7eead31-7a028791ee0mr1180582137.8.1789524287652; Tue, 15 Sep 2026 19:04:47 -0700 (PDT) Received: from cachyos ([2804:7f0:9f80:834e:ff40:6e50:a18b:5455]) by smtp.gmail.com with ESMTPSA id ada2fe7eead31-79facab39basm1631051137.2.2026.09.15.19.04.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 15 Sep 2026 19:04:47 -0700 (PDT) From: Ygor Otavio To: Daniel Pereira , Jonathan Corbet Cc: Shuah Khan , Randy Dunlap , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Ygor Otavio Subject: [PATCH] docs: translations: pt_BR: translate generated-content.rst Date: Tue, 15 Sep 2026 23:03:33 -0300 Message-ID: <20260916020335.17034-1-ygorotavio.sjc@gmail.com> X-Mailer: git-send-email 2.55.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Translate genetated-content.rst into Brazilian Portuguese, maintaining consistency with original formatting rules. And add it to the pt_BR process documentation index. Assisted-by: Claude:Sonnet-5 Signed-off-by: Ygor Otavio --- --- .../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-cont= ent.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 + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D +Diretrizes do Kernel para Conte=C3=BAdo Gerado por Ferramentas +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D + +Prop=C3=B3sito +=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Os contribuidores do kernel v=C3=AAm usando ferramentas para gerar contrib= ui=C3=A7=C3=B5es h=C3=A1 +muito tempo. Essas ferramentas podem aumentar o volume de contribui=C3=A7= =C3=B5es. Ao mesmo +tempo, o tempo dispon=C3=ADvel de revisores e mantenedores =C3=A9 um recur= so escasso. +Entender quais partes de uma contribui=C3=A7=C3=A3o v=C3=AAm de humanos e = quais v=C3=AAm de ferramentas +ajuda a preservar esses recursos e manter o desenvolvimento do kernel saud= =C3=A1vel. + +O objetivo aqui =C3=A9 esclarecer as expectativas da comunidade em rela=C3= =A7=C3=A3o a ferramentas. +Isso permite que todos se tornem mais produtivos, mantendo ao mesmo tempo = um alto +grau de confian=C3=A7a entre submetedores e revisores. + +Fora do Escopo +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Estas diretrizes n=C3=A3o se aplicam a ferramentas que fazem ajustes trivi= ais em +conte=C3=BAdo preexistente. Tamb=C3=A9m n=C3=A3o dizem respeito a ferramen= tas que ajudam em +tarefas menores. Alguns exemplos: + + - Corre=C3=A7=C3=B5es de ortografia e gram=C3=A1tica, como reformular par= a o modo imperativo + - Aux=C3=ADlios de digita=C3=A7=C3=A3o como completar identificadores, bo= ilerplate + ou completar padr=C3=B5es triviais + - Transforma=C3=A7=C3=B5es puramente mec=C3=A2nicas, como renomear vari= =C3=A1veis + - Reformata=C3=A7=C3=A3o, como executar o Lindent, ``clang-format`` ou ``= rust-fmt`` + +Mesmo quando o uso da sua ferramenta estiver fora do escopo, voc=C3=AA +ainda deve sempre considerar se informar ao revisor qual ferramenta +voc=C3=AA usou ajudaria na revis=C3=A3o da sua contribui=C3=A7=C3=A3o. + +No Escopo +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Estas diretrizes se aplicam quando uma quantidade significativa de conte= =C3=BAdo em +uma contribui=C3=A7=C3=A3o do kernel n=C3=A3o foi escrita por uma pessoa p= resente na cadeia de +Signed-off-by, mas sim criada por uma ferramenta. + +A detec=C3=A7=C3=A3o de um problema e o teste da corre=C3=A7=C3=A3o para e= le tamb=C3=A9m fazem parte do +processo de desenvolvimento; se uma ferramenta foi usada para encontrar um= problema +tratado por uma altera=C3=A7=C3=A3o, isso deve ser mencionado no changelog= . Isso n=C3=A3o apenas +d=C3=A1 o devido cr=C3=A9dito, como tamb=C3=A9m ajuda outros desenvolvedor= es a descobrir essas +ferramentas. + +Alguns exemplos: + - Qualquer corre=C3=A7=C3=A3o sugerida por ferramenta, como ``checkpatch.= pl --fix`` + - Scripts do Coccinelle + - Um chatbot gerou uma nova fun=C3=A7=C3=A3o no seu patch para ordenar en= tradas de lista. + - Um arquivo .c do patch foi originalmente gerado por um assistente de co= difica=C3=A7=C3=A3o, + mas foi limpo manualmente. + - O changelog foi gerado entregando o patch a uma ferramenta de IA genera= tiva e + pedindo que ela escrevesse o changelog. + - O changelog foi traduzido de outro idioma. + +Em caso de d=C3=BAvida, escolha a transpar=C3=AAncia e presuma que estas d= iretrizes se +aplicam =C3=A0 sua contribui=C3=A7=C3=A3o. + +Diretrizes +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Primeiro, leia o Developer's Certificate of Origin: +Documentation/process/submitting-patches.rst. Suas regras s=C3=A3o simples= e est=C3=A3o em +vigor h=C3=A1 muito tempo. Elas j=C3=A1 cobriram diversas contribui=C3=A7= =C3=B5es geradas por ferramentas. +Certifique-se de que voc=C3=AA entende toda a sua submiss=C3=A3o e est=C3= =A1 preparado para +responder aos coment=C3=A1rios de revis=C3=A3o. + +Segundo, ao fazer uma contribui=C3=A7=C3=A3o, seja transparente sobre a or= igem +do conte=C3=BAdo em cover letters e changelogs. Voc=C3=AA pode ser mais +transparente adicionando informa=C3=A7=C3=B5es como: + + - Quais ferramentas foram usadas? + - A entrada fornecida =C3=A0s ferramentas que voc=C3=AA usou, como o scri= pt de origem do + Coccinelle. + - Se o c=C3=B3digo foi majoritariamente gerado a partir de um =C3=BAnico = prompt ou um + pequeno conjunto de prompts, inclua esses prompts. Para sess=C3=B5es ma= is longas, + inclua um resumo dos prompts e da natureza da assist=C3=AAncia resultan= te. + - Quais partes do conte=C3=BAdo foram afetadas por essa ferramenta? + - Como a submiss=C3=A3o foi testada e quais ferramentas foram usadas para= testar a + corre=C3=A7=C3=A3o? + +Como em todas as contribui=C3=A7=C3=B5es, cada mantenedor tem a discricion= ariedade de escolher +como lidar com a contribui=C3=A7=C3=A3o. Por exemplo, eles podem: + + - Trat=C3=A1-la como qualquer outra contribui=C3=A7=C3=A3o. + - Rejeit=C3=A1-la de imediato. + - Tratar a contribui=C3=A7=C3=A3o de forma especial, por exemplo, pedindo= testes extras, + revisando com escrut=C3=ADnio adicional, ou revisando com prioridade me= nor do que + conte=C3=BAdo gerado por humanos. + - Pedir algum outro passo especial, como solicitar que o contribuidor det= alhe + como a ferramenta ou o modelo foi treinado. + - Pedir ao submetedor que explique em mais detalhes sobre a contribui=C3= =A7=C3=A3o, para + que o mantenedor possa se assegurar de que o submetedor entende complet= amente + como o c=C3=B3digo funciona. + - Sugerir um prompt melhor em vez de sugerir altera=C3=A7=C3=B5es espec= =C3=ADficas de c=C3=B3digo. + +Se as ferramentas permitirem que voc=C3=AA gere uma contribui=C3=A7=C3=A3o= automaticamente, +espere escrut=C3=ADnio adicional proporcional a quanto dela foi gerado. + +Como com a sa=C3=ADda de qualquer ferramenta, o resultado pode estar incor= reto ou +inadequado. Espera-se que voc=C3=AA entenda e seja capaz de defender tudo = o que submeter. +Se voc=C3=AA n=C3=A3o for capaz de fazer isso, ent=C3=A3o n=C3=A3o submeta= as altera=C3=A7=C3=B5es resultantes. + +Se voc=C3=AA o fizer mesmo assim, os mantenedores t=C3=AAm o direito de re= jeitar sua s=C3=A9rie +sem revis=C3=A3o detalhada. + +Refer=C3=AAncias +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Para diretrizes espec=C3=ADficas sobre assistentes de codifica=C3=A7=C3=A3= o de IA, veja: + + +* Documentation/process/coding-assistants.rst diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documenta= tion/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=C3=A3o as regras pelas quais tentamos viver na co= munidade do kernel Modelos de Maturidade para Contribui=C3=A7=C3=A3o no Kernel Linux Declara=C3=A7=C3=A3o sobre Drivers do Kernel Estilo de gerenciamento do kernel Linux + Diretrizes do Kernel para Conte=C3=BAdo Gerado por Ferramentas Conclave (Continuidade do projeto) =20 Lidando com bugs --=20 2.55.0