From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=74.125.82.171 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1792469648; b=Abhq2I/eiSG3xCyp+u2DPWMnZQDhHMjEdx30AwSFp1EiBtBAe6jmMBHEA0hCKaGBBaAC 4pJbNjvtYKdMnaRrKBkTiS30dVRq1NjHj74eZonn3Wmup3x0wt3qXCtoLHxHoEKKsd+0K xDVPfbal55Dltf9X2w4IdK/rHU0+KMgI7dEVpq73B5rWSwplQtwFM2gT3yP3JaK2SmkoG exCKTZrbyux5g7M6KTB7nCm2FqlcM/1VUI+/euCY5c0I4uG7ybMWsQk8q6O0a7nxjr5fc 9qnKaz7y+lZkfvGZjRswl3p1xuYqmQ0pp4IHgrEjlbo140b68AMxSLXC8MAJxydRkXw== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1792469648; h=DMARC-Filter:Received:DKIM-Signature:X-Google-DKIM-Signature: X-Forwarded-Encrypted:X-Gm-Message-State:X-Gm-Gg:X-Received:Received: From:To:Cc:Subject:Date:Message-ID:X-Mailer:In-Reply-To:References: MIME-Version:Content-Type:Content-Transfer-Encoding; bh=o68p/6aoo8jLJxqjN+WPuuOUaI2Z1MpIHdwtTNRzrUA=; b=5Fc3eRlgUTMNuf9VYfWdI98kpokwCAVPD+1+phY+zM/gOQxEP0pSetqz1GqtvlBY07Zy NOd1iJsOEfBNYtR0u7LonjcrpGS1VTxByI5tIrwnv1KPv5h974BGqR6bh/afeA/Wr/qLE bi3y2LQPgpen1Equ81mRjWSZZFEzllksSlIxOs4+wGZIT1nCX51RycS5gg7M5iW7xaWxF FlD8P3kD1zT+IuzIf2Uy9TLL6wULsToY3whNSULBdJTpbgQYcbEcQiMsBrH7b6XmSuDJ/ zzDs+DVnJQvnVQTlm5+p2x76ca+2ieycPq5eDSXZvjYSJ3VIDcQkpiG12gtq6WxxH6Q== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20251104 header.b=noVuHcmG; arc=none smtp.remote-ip=74.125.82.171 Received: from mail-dy1-f171.google.com (mail-dy1-f171.google.com [74.125.82.171]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9BB74606A31A for ; Tue, 20 Oct 2026 04:14:07 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 9BB74606A31A 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, unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20251104 header.b=noVuHcmG Received: by mail-dy1-f171.google.com with SMTP id 5a478bee46e88-3535a54bed9so3910235eec.1 for ; Mon, 19 Oct 2026 21:14:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1792469647; x=1793074447; darn=vger.kernel.org; h=content-transfer-encoding:content-type:mime-version:references :in-reply-to:message-id:date:subject:cc:to:from:from:to:cc:subject :date:message-id:reply-to:content-type; bh=o68p/6aoo8jLJxqjN+WPuuOUaI2Z1MpIHdwtTNRzrUA=; b=noVuHcmGayq+gNnF/+rkK7AoiGdkh5PIwlX5YO34+DjEBDCnwK+vS4/vkA/t3FPaMV 9mfQE8PFf1XFeS3xOsIKuAlhGrpYAbGW1bW5O+sKx3GcP8YSq1kFi+uMpGAJcPPx2/Cx +U63cBtYwm72rX868LBxzBVBDnroXTcieaSPX2y5hGGuQNnjxeK2KnaNXvdN/XI72w3u qFVCxGwlzS8ql0lK0uWS5/ZSNNP10TSXE8eh3mYWrOqG+IeKOdrteSO+C+kDGNDAcL4u bNTwYsz+xng2wTUgf4tD62rzcyJuXlzGn5WuB3J7cpSDoszLIVVq0GtkzbBvM3c2l1hy P1pw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1792469647; x=1793074447; h=content-transfer-encoding:content-type:mime-version:references :in-reply-to: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=o68p/6aoo8jLJxqjN+WPuuOUaI2Z1MpIHdwtTNRzrUA=; b=xNPiaBbuC6TQqqZ7LOFizSxPWHo8airFzOYt+S7EUOj4OgVIhr74v81Atv0A6kPGVw HslKnoXOEQPYmhRTWBk8RI2IuotEnVW/MifLT1SRnQeecr/ZXYjjbKkN3YV2uiTxIjSW DXVTCXLKf08DSmyK3B4umcC9gxKHFoN+3NRA389fWgQEZww6G8RqavIvH00keGEHIEmf 9+8yOKSYsONx8WWIwIav+3mR42cZ+wCDt0qQ4NeUZQVzSiJd34LMEgkDft5W4gS7FcZO TjZ3rDjqLXIO9UgXfNqP/6RaaBVwthxCo/Ts9yUd4xUktlsA6Ep61Q2IXwsaoabDFgRi xTUw== X-Forwarded-Encrypted: i=1; AKwUvBz6Hl4SXLPDGreFEUDmlLNJHDenOdqbkMzDur9C23Bk6T6b/Tg5TTiJ0q1RwWQ02c9XtFBAKZrW+4c=@vger.kernel.org X-Gm-Message-State: AFq9FYJkru6A8fmG5umUStGunf5zujfIEdeD7DlOa8LhWOh+DnDrhqZP dow/W3U4Bmj+ZvigCKiD3ybzXLJvS+glM26SoLsriVAN5X9uxi9YOXgv X-Gm-Gg: AYBFou2yTryc4LYE47immeI+praZxPuyQ4XXyYT0kZS+Dr+dGmA/uj2E3swUbc2QL7h HyS8Eo1dmzF5m5yaBP3uMU+tUsbQQSMYGzyZKKIbDALm9q/gAyJ3tVHwR+svfLCQG0RPQep3vkJ Il7mL9orTVB+VVlc+qv9zzfVHWOgobOr+kn4m5RVMhAwGwQjiJnWYssxVPidANT0NNdnfentkr8 iZUKvQT59IFRp+8c4pd5bk5dddvhXza0WItuvR7lr1O8r78/8mWX1jgDxiBb3lwkF5dXLn4F4Gm FemD8EYhd1vobaFAAFLDrS6feP9W10cKNAl1UipSP8kKSlVDRoxj6JuhOVWuhA4tYGh6Xq8W64d 8BXCt55aPipabVbVgsC0+liXvt2FgmpnXuICFd2mTuXhQ/OVTFVZpWnrt3Sw3QNyGKmYM9FuaYp UUP2XmJP3erHdEb7K5uVXbTpaZ0A4TQv5exzjitlArQLl1eyfJEIOC4H3o6rIXbE5Ayvr8CHOIr OfEsVAn7MihCQ== X-Received: by 2002:a05:7300:7a9e:b0:361:1dd6:531b with SMTP id 5a478bee46e88-361a2052bebmr12351871eec.26.1792469646588; Mon, 19 Oct 2026 21:14:06 -0700 (PDT) Received: from fedora ([2804:29b8:508d:af45:a398:9dc5:b37c:dfa8]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-360826875b3sm38861428eec.21.2026.10.19.21.14.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 19 Oct 2026 21:14:06 -0700 (PDT) From: Lucas Adryell Ramalho To: danielmaraboo@gmail.com, corbet@lwn.net Cc: skhan@linuxfoundation.org, rdunlap@infradead.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Lucas Adryell Ramalho Subject: [PATCH v2 2/3] docs: translations: pt_BR: process: Translate researcher-guidelines.rst Date: Tue, 20 Oct 2026 01:13:37 -0300 Message-ID: <20261020041340.447727-3-lucasadramalho@gmail.com> X-Mailer: git-send-email 2.55.0 In-Reply-To: <20261020041340.447727-1-lucasadramalho@gmail.com> References: <20261020041340.447727-1-lucasadramalho@gmail.com> X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Translate researcher-guidelines.rst into Brazilian Portuguese and add it to the process documentation index. Signed-off-by: Lucas Adryell Ramalho --- .../translations/pt_BR/process/index.rst | 1 + .../pt_BR/process/researcher-guidelines.rst | 188 ++++++++++++++++++ 2 files changed, 189 insertions(+) create mode 100644 Documentation/translations/pt_BR/process/researcher-guidelines.rst diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst index d072f7e46..31704e28d 100644 --- a/Documentation/translations/pt_BR/process/index.rst +++ b/Documentation/translations/pt_BR/process/index.rst @@ -64,6 +64,7 @@ Estas são as regras pelas quais tentamos viver na comunidade do kernel Declaração sobre Drivers do Kernel A interface de drivers do kernel Linux Estilo de gerenciamento do kernel Linux + Diretrizes para pesquisadores Assistentes de código O manual da árvore tip Conclave (Continuidade do projeto) diff --git a/Documentation/translations/pt_BR/process/researcher-guidelines.rst b/Documentation/translations/pt_BR/process/researcher-guidelines.rst new file mode 100644 index 000000000..8209b0e17 --- /dev/null +++ b/Documentation/translations/pt_BR/process/researcher-guidelines.rst @@ -0,0 +1,188 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. _pt_BR_researcher-guidelines: + +Diretrizes para pesquisadores ++++++++++++++++++++++++++++++ + +A comunidade do kernel do Linux acolhe com satisfação pesquisas +transparentes sobre o kernel do Linux, as atividades envolvidas em seu +desenvolvimento e quaisquer outros subprodutos de seu desenvolvimento. O +Linux se beneficia enormemente desse tipo de pesquisa, e a maioria dos +aspectos do Linux é impulsionada por pesquisas, de uma forma ou de outra. + +A comunidade agradece imensamente se os pesquisadores puderem compartilhar +descobertas preliminares antes de tornar seus resultados públicos, +especialmente se tal pesquisa envolver segurança. O envolvimento antecipado +da comunidade ajuda a melhorar tanto a qualidade da pesquisa quanto a +capacidade do Linux de se beneficiar de seus resultados. De qualquer forma, +recomenda-se compartilhar com a comunidade cópias de acesso aberto das +pesquisas publicadas. + +Este documento tem como objetivo esclarecer o que a comunidade do kernel +Linux considera práticas aceitáveis e inaceitáveis na condução desse tipo +de pesquisa. No mínimo, tais pesquisas e atividades relacionadas devem +seguir os princípios fundamentais da ética em pesquisa. Para obter mais +informações sobre ética em pesquisa em geral, ética em tecnologia e +pesquisa sobre comunidades de desenvolvedores em particular, consulte: + +* `História da Ética em Pesquisa + `_ +* `Ética do IEEE `_ +* `Opiniões de desenvolvedores e pesquisadores sobre a ética de + experimentos em projetos de código aberto + `_ + +A comunidade do kernel Linux espera que todos os que interagem com o +projeto estejam participando de boa-fé para tornar o Linux melhor. +Pesquisas sobre qualquer material disponível publicamente (incluindo, mas +não se limitando ao código-fonte) produzido pela comunidade do kernel Linux +são bem-vindas, embora pesquisas envolvendo desenvolvedores exijam +consentimento explícito dos participantes. + +Pesquisas passivas baseadas inteiramente em fontes publicamente +disponíveis, incluindo postagens em listas de discussão públicas e commits +em repositórios públicos, são claramente permitidas. No entanto, como em +qualquer pesquisa, os princípios éticos padrão devem ser seguidos. + +A pesquisa ativa sobre o comportamento dos desenvolvedores, no entanto, +deve ser realizada com o consentimento explícito e a plena divulgação aos +desenvolvedores individuais envolvidos. Não é permitido interagir com os +desenvolvedores ou realizar experimentos com eles sem o consentimento; isso +também faz parte da ética padrão da pesquisa. + +Questionários +============= + +A pesquisa geralmente assume a forma de questionários enviados a +mantenedores ou colaboradores. Como regra geral, porém, a comunidade do +kernel obtém pouco valor desses questionários. O processo de +desenvolvimento do kernel funciona porque cada desenvolvedor se beneficia +de sua participação, mesmo trabalhando com outras pessoas que têm objetivos +diferentes. Responder a um questionário, porém, é uma exigência unilateral +imposta a desenvolvedores ocupados, sem nenhum benefício correspondente +para eles próprios ou para a comunidade do kernel como um todo. Por esse +motivo, esse método de pesquisa não é recomendado. + +Os membros da comunidade do kernel já recebem e-mails em excesso e +provavelmente perceberão os pedidos de pesquisa como apenas mais uma +exigência sobre seu tempo. O envio desses pedidos priva a comunidade do +valioso tempo dos colaboradores e é improvável que gere uma resposta +estatisticamente útil. + +Como alternativa, os pesquisadores devem considerar participar de eventos +de desenvolvedores, organizar sessões nas quais o projeto de pesquisa e +seus benefícios para os participantes possam ser explicados e interagir +diretamente com a comunidade no local. As informações recebidas serão +muito mais ricas do que as obtidas por meio de uma pesquisa por e-mail, e a +comunidade também se beneficiará da oportunidade de aprender com suas +percepções. + +Patches +======= + +Para ajudar a esclarecer: enviar patches aos desenvolvedores *é* interagir +com eles, mas eles já consentiram em receber *contribuições de boa-fé*. +Esse consentimento não se estende ao envio de patches intencionalmente +defeituosos ou vulneráveis, nem ao fornecimento de informações enganosas +durante as discussões. Essas interações podem prejudicar os desenvolvedores +ao consumir tempo, esforço e motivação, além de prejudicar o projeto ao +minar a confiança de toda a comunidade de desenvolvedores no colaborador (e +na organização do colaborador como um todo), prejudicando os esforços para +fornecer feedback construtivo aos colaboradores e colocando os usuários +finais em risco de falhas de software. + +A participação de pesquisadores no desenvolvimento do próprio Linux, assim +como a de qualquer pessoa, é bem-vinda e incentivada. A pesquisa no código +do Linux é uma prática comum, especialmente quando se trata de desenvolver +ou executar ferramentas de análise que produzam resultados que possam ser +utilizados na prática. + +Ao interagir com a comunidade de desenvolvedores, enviar um patch tem sido, +tradicionalmente, a melhor maneira de causar impacto. O Linux já possui +muitos bugs conhecidos — o que é muito mais útil é dispor de correções +revisadas e verificadas. Antes de contribuir, leia atentamente a +documentação apropriada: + +* Documentation/process/development-process.rst +* Documentation/process/submitting-patches.rst +* Documentation/admin-guide/reporting-issues.rst +* Documentation/process/security-bugs.rst + +Em seguida, envie um patch (incluindo uma mensagem de commit com todos os +detalhes listados abaixo) e responda aos comentários dos outros +desenvolvedores. + +Ao enviar patches resultantes de pesquisas, as mensagens de commit devem +conter, no mínimo, os seguintes detalhes, para que os desenvolvedores +tenham o contexto adequado para compreender a contribuição. Responda às +seguintes perguntas: + +* Qual é o problema específico que foi identificado? +* Como o problema poderia ser reproduzido em um sistema em execução? +* Que efeito a ocorrência do problema teria no sistema? +* Como o problema foi identificado? Inclua, especificamente, detalhes sobre + quaisquer testes, programas de análise estática ou dinâmica e quaisquer + outras ferramentas ou métodos utilizados para realizar o trabalho. +* Em qual versão do Linux o problema foi identificado? É altamente + recomendável utilizar a versão mais recente ou um ramo recente do + linux-next (consulte Documentation/process/howto.rst). +* O que foi alterado para corrigir o problema e por que se acredita que a + correção esteja correta? +* Como a alteração foi testada na compilação e em tempo de execução? +* Qual commit anterior esta alteração corrige? Isso deve constar na tag + “Fixes:” conforme descrito na documentação. +* Quem mais revisou este patch? Isso deve constar nas tags apropriadas + “Reviewed-by:”; veja abaixo. + +Por exemplo:: + + From: Author + Subject: [PATCH] drivers/foo_bar: Add missing kfree() + + The error path in foo_bar driver does not correctly free the allocated + struct foo_bar_info. This can happen if the attached foo_bar device + rejects the initialization packets sent during foo_bar_probe(). This + would result in a 64 byte slab memory leak once per device attach, + wasting memory resources over time. + + This flaw was found using an experimental static analysis tool we are + developing, LeakMagic[1], which reported the following warning when + analyzing the v5.15 kernel release: + + path/to/foo_bar.c:187: missing kfree() call? + + Add the missing kfree() to the error path. No other references to + this memory exist outside the probe function, so this is the only + place it can be freed. + + x86_64 and arm64 defconfig builds with CONFIG_FOO_BAR=y using GCC + 11.2 show no new warnings, and LeakMagic no longer warns about this + code path. As we don't have a FooBar device to test with, no runtime + testing was able to be performed. + + [1] https://url/to/leakmagic/details + + Reported-by: Researcher + Fixes: aaaabbbbccccdddd ("Introduce support for FooBar") + Signed-off-by: Author + Reviewed-by: Reviewer + +Se você estiver contribuindo pela primeira vez, recomenda-se que o patch +seja avaliado por outras pessoas em particular antes de ser enviado às +listas de discussão públicas. +(Isso é obrigatório caso tenha sido explicitamente informado de que seus +patches precisam de uma revisão interna mais cuidadosa.) Espera-se que +essas pessoas tenham sua tag “Reviewed-by” incluída no patch resultante. +Encontrar outro desenvolvedor familiarizado com contribuições para o Linux, +especialmente dentro da sua própria organização, e pedir que ele ajude nas +revisões antes de enviá-las para as listas de discussão públicas tende a +melhorar significativamente a qualidade dos patches resultantes e, com isso, +reduz a carga de trabalho sobre outros desenvolvedores. + +Se não for possível encontrar ninguém para revisar os patches internamente +e você precisar de ajuda para encontrar essa pessoa, ou se tiver quaisquer +outras dúvidas relacionadas a este documento e às expectativas da +comunidade de desenvolvedores, entre em contato com a lista de discussão +privada do Conselho Consultivo Técnico: +. -- 2.55.0