From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=209.85.128.169 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1794585754; b=dhl88y9Zz3KoRZZ3fqjYOq9lIDuXD9w5sXjyo/ODC4CQWVXNo6IS1YfnrVT8HhY1SNxc zD49KGFvP9TrPQrRzMiC7HsbJwNl3XZrqRyD9F6ZZg+LtcAGU59tT9yPMCOdaZZBjrusk knE8RyCgK1cf3ZMyG1T7jeenW0M5v3KCUks/pieyAz6Y3ghzwcxbeTzzWmJQ6EiFtlKU/ kHpFJVCzxQwSpySrHv234XC1JUb93ZDEQNcUZI6AWwDXd3rw106DMu19jF4PFsqtolXuK eThkIb2GicGRAub+YLRvIpguXWGe0V6vGvc7ev1NtI9mDz9NnPOYzRQGWBnLKbuvUMA== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794585754; 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:MIME-Version:Content-Type: Content-Transfer-Encoding; bh=MNUoIzyeaKo/uF6h8gon1B39RII7Y8clZOK5xI9vBmY=; b=ipgUQ1UGXCsHreHt/nhB79BkTnWZOFdF5DcyroCGdei3ZGb28VFH4WY56Qo1DBy8ujvP oaGSkttS9G+qQO3I0VvZuD0eCSsK0AWsIX9kC6UoLNgPTkFzyeYRr2vbNOhz0ZQLaVRte O+CkLcTJKKHaB7r3XiGKMGUDDM5jOJGSbAnEJsxO1D9ynL1OenGURsgJmZwPj/d4uZ/lP Hb1giyNa2J3LoBRPwEPZHmz1RQ6oL29sQ1SXTW4c8+1WhtuWlGLRH84+hPr7FXGP2Type 07jKMdsGAawyP0OL52jRNAOPn3REcZrNxsX52w8bs/oaWKIkUyQ6Avf5eGpRJdEM1PQ== 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=20260707 header.b=pxsPxteg; arc=none smtp.remote-ip=209.85.128.169 Received: from mail-yw1-f169.google.com (mail-yw1-f169.google.com [209.85.128.169]) (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 18E53606AE20 for ; Fri, 13 Nov 2026 16:02:32 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 18E53606AE20 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.a=rsa-sha256 header.s=20260707 header.b=pxsPxteg Received: by mail-yw1-f169.google.com with SMTP id 00721157ae682-8b3a332105bso10487367b3.1 for ; Fri, 13 Nov 2026 08:02:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20260707; t=1794585752; x=1795190552; 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=MNUoIzyeaKo/uF6h8gon1B39RII7Y8clZOK5xI9vBmY=; b=pxsPxteg6J3nI56+e5asagA9q3vTZM5YhhZlkV2F4SsuwFvU51T4jtC3vKKohuDyQw YM77XieyG9GMoUorWhwmeup/er3NomA+z9optgxaMApBvGiFLSd3Ru9Oe5JLK64YFdnE gLXLcFzeywCLM2HGxyPXID2fFXZf+8kK5k1e/sPgwEcVGIkYUN1vlur8psdUs35dydf4 nHBrgh6BH9Bbx7BrWOG1rW4RH6AFLXufp52eZ6+C9lNa0DolxqVk+b5zdDa6/3sP3pyG VIkLX7DvBoVdUsWhpapVrq2Z9ypl/wFKiYf2I/e7CrvDHOcSYNC5hya7VGHA0q3mN6rJ AwOw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1794585752; x=1795190552; 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=MNUoIzyeaKo/uF6h8gon1B39RII7Y8clZOK5xI9vBmY=; b=WP6qsm+eH1e4fgjXrZRF0HYVtoMciAbvSBXRFk3Llmp86/KNbDQwmudOhPaJAHK+vF Pdg8rOoU4u12VHrVaXDDxTwg95k5XPHIUo7AGbw526XAqf8kwPJB5w0pWExSlPepAGZn i+7kfW1nuo1CyQAQJAmu6wZqEfk9NvCjj9ZjyBbK8YZGkKTI3qMAgzgaaLaRvzUiQTmi 5uHJD6ohDzUp1DKNsTG3crhWmdTn+gXiw12XFNWG6ZeuEmNKHcDKCXx8NhXUOgX4YRZj 314y8sUTrchEmY/JUGu7R2vMqaGVZWnuijDCEmbBlcXq0GdyeItBtFJKq3NiYGm/wbKP 1VmA== X-Forwarded-Encrypted: i=1; AL+hErEkhsKf4em3hTWM9/xSHYa7RZ86BSIdmgcr8WwrH/gVX/3dkzCoZ5H95i1oy5sQTN3FMrSGwzvw+h645k4=@vger.kernel.org X-Gm-Message-State: APuU4Z/yIHfDWwrgGCQmm+53dvn0ameqathQ6ctZKJm9YPq16UzIHhf9 2Sdbo5LsnUeEi126dJvwN+E946nPskxGLcLBtVHF/ZYGauV+8lpG69UB X-Gm-Gg: AYBFou1kUmDbHrMw/cH7t/x1p8AL5iljKImLRsDbUo7YztJs+y7TbnnM1VvZ/C58FoG ClzoK1k0mYleh5zEDD+KW5V80ojWFgZwnXWy/pvOqtCYKODQ32dgcpTD1P+pmtZRiHfXYDN+a8p l89UjIf5NPRL5hTlkghMZxZLAV1y2a2R6o597FB8KlUzQOlNyQy4now7SkUZkc5UepHpLIMKukq 1MK9WaSEpmix22FBAt2Lrf3p5wUG/VCmIZBBjpD1H9NgIzh/HJy/f9uMmyiyVE1y5+mlTEhAW6J bwI8ahLut/1kIympp+ZEhMRBN5mG1IQHhg/qXfkaFfvQ87NNO5hM2wC2+iKAqX2W1MvJugzimhC +kpA/ILXziwMQhYgNuQjdKM3ymeMtw6ngcj4M0EKvcchMF0c8Kvi0Q9kQADuCdf1d1YqHXCcdLi CEmIBv8/EdcofGYnt1YfkovzdlY+AR/46dXyQSFCAVRzybnOZyP9vZ5REldpT5R64EcMTuLDLR/ esQA00z7xQBaPLoqNHREu0IcHF8BFQxQsI0cS5NAfDqvOTGoJMOiGm9LIFwydVIdClCdHYcxwPe OmlX0BgaSCgETLSj+0t+TMMXDfv+gpLYWVXTeUbeXbLYE3J4QDybj7ySj26ORnqX8mcf6C+z+F3 0hTI= X-Received: by 2002:a05:690c:e20b:10b0:8b1:60a0:c311 with SMTP id 00721157ae682-8b4aa2fa74dmr11913577b3.33.1794585750867; Fri, 13 Nov 2026 08:02:30 -0800 (PST) Received: from dell-pro-plus ([2804:29b8:5080:dd51:39c5:770e:6bea:512e]) by smtp.gmail.com with ESMTPSA id 00721157ae682-8b4aa7f1a0dsm23456747b3.1.2026.11.13.08.02.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 13 Nov 2026 08:02:29 -0800 (PST) From: Gabriel Ribeiro To: linux-doc@vger.kernel.org Cc: danielmaraboo@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org, rdunlap@infradead.org, linux-kernel@vger.kernel.org, Gabriel Ribeiro Subject: [PATCH] docs: translations: pt_BR: add researcher guidelines Date: Fri, 13 Nov 2026 13:01:53 -0300 Message-ID: <20261113160153.216027-1-ic.gabrielribeiro@gmail.com> X-Mailer: git-send-email 2.56.0 X-Mailing-List: linux-kernel@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 the kernel researcher guidelines into Brazilian Portuguese and link the page from the pt_BR process index. --- Documentation/translations/pt_BR/process/index.rst | 1 + .../pt_BR/process/researcher-guidelines.rst | 176 ++++++++++++++++++ 2 files changed, 177 insertions(+) diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst index da92a7026e..05f4cd7915 100644 --- a/Documentation/translations/pt_BR/process/index.rst +++ b/Documentation/translations/pt_BR/process/index.rst @@ -63,10 +63,11 @@ Estas são as regras pelas quais tentamos viver na comunidade do kernel Interpretação do Código de Conduta do Kernel Linux Modelos de Maturidade para Contribuição no Kernel Linux Declaração de Aplicação do Kernel Linux - Declaração sobre Drivers do Kernel - A interface de drivers do kernel Linux - Estilo de gerenciamento do kernel Linux - Assistentes de código + 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 0000000000..5ebc72cd2d --- /dev/null +++ b/Documentation/translations/pt_BR/process/researcher-guidelines.rst @@ -0,0 +1,176 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. _pt_BR_researcher_guidelines: + +Diretrizes para pesquisadores ++++++++++++++++++++++++++++++ + +A comunidade do kernel Linux dá boas-vindas à pesquisa transparente sobre o +kernel Linux, as atividades envolvidas em sua produção e quaisquer outros +subprodutos de seu desenvolvimento. O Linux se beneficia muito desse tipo de +pesquisa, e a maioria de seus aspectos é impulsionada por pesquisas de uma +forma ou de outra. + +A comunidade agradece muito quando pesquisadores compartilham resultados +preliminares antes de torná-los públicos, especialmente se a pesquisa envolver +segurança. O envolvimento antecipado ajuda a melhorar a qualidade da pesquisa +e também a capacidade do Linux de melhorar a partir dela. Em qualquer caso, +recomenda-se compartilhar com a comunidade cópias de acesso aberto dos +trabalhos publicados. + +Este documento busca esclarecer quais práticas a comunidade do kernel Linux +considera aceitáveis e inaceitáveis na realização desse tipo de pesquisa. No +mínimo, essas pesquisas e atividades relacionadas devem seguir as regras +padrão de ética em pesquisa. Para saber mais sobre ética em pesquisa em geral, +ética em tecnologia e, em particular, pesquisa sobre comunidades de +desenvolvedores, consulte: + +* `História da ética em pesquisa `_ +* `Ética da IEEE `_ +* `Perspectivas de desenvolvedores e pesquisadores sobre a ética de experimentos em projetos de código aberto `_ + +A comunidade do kernel Linux espera que todos que interagem com o projeto +estejam agindo de boa-fé para tornar o Linux melhor. Pesquisas sobre qualquer +artefato produzido pela comunidade do kernel Linux que esteja disponível +publicamente (incluindo, mas não se limitando ao código-fonte) são bem-vindas; +pesquisas sobre desenvolvedores, porém, devem ocorrer somente mediante adesão +explícita dos próprios desenvolvedores. + +Pesquisas passivas baseadas inteiramente em fontes disponíveis publicamente, +incluindo publicações em listas de discussão públicas e commits em +repositórios públicos, são claramente permitidas. Ainda assim, como em +qualquer pesquisa, a ética padrão deve ser respeitada. + +Pesquisas ativas sobre o comportamento de desenvolvedores, por outro lado, +devem ser realizadas com o acordo explícito dos desenvolvedores envolvidos e +com plena divulgação a cada um deles. Não se pode interagir com +desenvolvedores nem realizar experimentos com eles sem consentimento; isso +também faz parte da ética padrão em pesquisa. + +Questionários +============= + +Pesquisas frequentemente assumem 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 todos os desenvolvedores se beneficiam de sua +participação, inclusive ao trabalhar com outros que têm objetivos diferentes. +Responder a um questionário, porém, é uma demanda unilateral imposta a +desenvolvedores ocupados, sem benefício correspondente para eles ou para a +comunidade do kernel como um todo. Por esse motivo, esse método de pesquisa +é desencorajado. + +Os membros da comunidade do kernel já recebem emails em excesso e +provavelmente verão pedidos para responder a questionários como mais uma +demanda por seu tempo. Enviar esses pedidos priva a comunidade do tempo +valioso de seus colaboradores e dificilmente produzirá respostas +estatisticamente úteis. + +Como alternativa, pesquisadores devem considerar participar de eventos para +desenvolvedores, organizar sessões em que possam explicar o projeto de +pesquisa e seus benefícios para os participantes e interagir diretamente com +a comunidade nesses eventos. As informações obtidas serão muito mais ricas +que as de um questionário por email, e a comunidade também poderá aprender +com as percepções dos pesquisadores. + +Patches +======= + +Para esclarecer: enviar patches aos desenvolvedores *é* interagir com eles, +mas eles já consentiram em receber *contribuições de boa-fé*. Não há +consentimento para enviar patches intencionalmente defeituosos ou vulneráveis, +nem para contribuir com informações enganosas nas discussões. Esse tipo de +comunicação pode prejudicar o desenvolvedor (por exemplo, consumindo tempo, +esforço e ânimo) e o projeto, ao corroer a confiança de toda a comunidade de +desenvolvimento no colaborador (e também na organização à qual ele pertence), +prejudicar os esforços para oferecer feedback construtivo aos colaboradores +e expor os usuários finais ao risco de falhas de software. + +A participação de pesquisadores no próprio desenvolvimento do Linux, assim +como a de qualquer pessoa, é bem-vinda e incentivada. Pesquisar o código do +Linux é uma prática comum, especialmente ao desenvolver ou executar +ferramentas de análise que produzam resultados acionáveis. + +Ao interagir com a comunidade de desenvolvimento, enviar um patch tem sido +tradicionalmente a melhor maneira de causar impacto. O Linux já tem muitos +bugs conhecidos — o que é muito mais útil são correções 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 acompanhe qualquer feedback de outros +desenvolvedores. + +Ao enviar patches produzidos a partir de pesquisas, as mensagens de commit +devem conter pelo menos os detalhes a seguir, para que os desenvolvedores +tenham contexto suficiente para entender a contribuição. Responda: + +* Qual é o problema específico encontrado? +* Como se pode chegar a esse problema em um sistema em execução? +* Que efeito a ocorrência do problema teria no sistema? +* Como o problema foi encontrado? Especificamente, inclua detalhes sobre + quaisquer testes, programas de análise estática ou dinâmica e outras + ferramentas ou métodos usados no trabalho. +* Em qual versão do Linux o problema foi encontrado? Recomenda-se fortemente + usar a versão mais recente ou um branch recente do linux-next (veja + Documentation/process/howto.rst). +* O que foi alterado para corrigir o problema e por que se acredita que a + correção está correta? +* Como a alteração foi testada em compilação e em tempo de execução? +* Qual commit anterior esta alteração corrige? Isso deve constar em uma tag + "Fixes:", conforme descrito na documentação. +* Quem mais revisou este patch? Isso deve constar nas tags "Reviewed-by:" + apropriadas; 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ê está contribuindo pela primeira vez, recomenda-se que o patch seja +revisado por outras pessoas em caráter privado antes de ser enviado às listas +públicas. (Isso é obrigatório se tiverem lhe dito explicitamente que seus +patches precisam de uma revisão interna mais cuidadosa.) Espera-se que essas +pessoas tenham a tag "Reviewed-by" incluída no patch resultante. Encontrar +outro desenvolvedor familiarizado com contribuições ao Linux, especialmente +na sua própria organização, e pedir ajuda para revisar antes do envio às +listas públicas tende a melhorar significativamente a qualidade dos patches +e, assim, reduzir a carga de trabalho de outros desenvolvedores. + +Se não for possível encontrar alguém para revisar os patches internamente e +você precisar de ajuda para encontrar essa pessoa, ou se tiver outras dúvidas +sobre este documento e as expectativas da comunidade de desenvolvimento, +entre em contato com a lista privada de emails do Conselho Consultivo +Técnico: .