Linux Documentation
 help / color / mirror / Atom feed
From: Fabio Pereira da Silva <silvapfabio@gmail.com>
To: Daniel Pereira <danielmaraboo@gmail.com>
Cc: Jonathan Corbet <corbet@lwn.net>, linux-doc@vger.kernel.org
Subject: [PATCH] docs: pt_BR: process: Translate patch submission checklist
Date: Tue, 25 Aug 2026 16:03:48 -0300	[thread overview]
Message-ID: <20260825190348.12701-1-silvapfabio@gmail.com> (raw)

Translate Documentation/process/submit-checklist.rst into Brazilian Portuguese and link it from the pt_BR documentation index.

Signed-off-by: Fabio Pereira da Silva <silvapfabio@gmail.com>
---
 Documentation/translations/pt_BR/index.rst    |   1 +
 .../pt_BR/process/submit-checklist.rst        | 141 ++++++++++++++++++
 2 files changed, 142 insertions(+)
 create mode 100644 Documentation/translations/pt_BR/process/submit-checklist.rst

diff --git a/Documentation/translations/pt_BR/index.rst b/Documentation/translations/pt_BR/index.rst
index dcc238a5ecfe..c09afbe8e22c 100644
--- a/Documentation/translations/pt_BR/index.rst
+++ b/Documentation/translations/pt_BR/index.rst
@@ -72,6 +72,7 @@ kernel e sobre como ver seu trabalho integrado.
    Como começar <process/howto>
    Requisitos mínimos <process/changes>
    CVEs <process/cve>
+   Lista de verificação para patches <process/submit-checklist>
    Conclave (Continuidade do projeto) <process/conclave>
    Manuais dos mantenedores <process/maintainer-handbooks>
    Processo do subsistema de rede (netdev) <process/maintainer-netdev>
diff --git a/Documentation/translations/pt_BR/process/submit-checklist.rst b/Documentation/translations/pt_BR/process/submit-checklist.rst
new file mode 100644
index 000000000000..f53b76268641
--- /dev/null
+++ b/Documentation/translations/pt_BR/process/submit-checklist.rst
@@ -0,0 +1,141 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. _pt_submitchecklist:
+
+=================================================================
+Lista de verificação para submissão de patches do kernel Linux
+=================================================================
+
+Aqui estão algumas coisas básicas que os desenvolvedores devem fazer se
+quiserem ver suas submissões de patches para o kernel aceitas mais rapidamente.
+
+Tudo isso vai além da documentação fornecida em
+:ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
+e em outros lugares sobre a submissão de patches para o kernel Linux.
+
+Revise seu código
+=================
+
+1) Se você usa uma funcionalidade, então inclua com #include o arquivo que
+   define/declara essa funcionalidade. Não dependa de outros arquivos de
+   cabeçalho para incluírem aqueles que você usa.
+
+2) Verifique o estilo geral do seu patch, conforme detalhado em
+   :ref:`Documentation/process/coding-style.rst <codingstyle>`.
+
+3) Todas as barreiras de memória {por exemplo, ``barrier()``, ``rmb()``,
+   ``wmb()``} precisam de um comentário no código-fonte que explique a lógica
+   do que elas estão fazendo e por quê.
+
+Revise alterações de Kconfig
+============================
+
+1) Quaisquer opções ``CONFIG`` novas ou modificadas não devem desorganizar o menu
+   de configuração e devem vir desativadas por padrão, a menos que atendam aos
+   critérios de exceção documentados em ``Documentation/kbuild/kconfig-language.rst``
+   Atributos de menu: valor padrão.
+
+2) Todas as novas opções ``Kconfig`` devem ter texto de ajuda.
+
+3) Deve ter sido revisado cuidadosamente em relação às combinações relevantes
+   de ``Kconfig``. É muito difícil acertar isso com testes; raciocínio
+   cuidadoso compensa aqui.
+
+Forneça documentação
+====================
+
+1) Inclua :ref:`kernel-doc <kernel_doc>` para documentar APIs globais do kernel.
+   (Não é obrigatório para funções estáticas, mas também é aceitável nelas.)
+
+2) Todas as novas entradas em ``/proc`` devem ser documentadas em
+   ``Documentation/``.
+
+3) Todos os novos parâmetros de inicialização do kernel devem ser documentados
+   em ``Documentation/admin-guide/kernel-parameters.rst``.
+
+4) Todos os novos parâmetros de módulo devem ser documentados com
+   ``MODULE_PARM_DESC()``.
+
+5) Todas as novas interfaces de espaço de usuário devem ser documentadas em
+   ``Documentation/ABI/``. Veja Documentation/admin-guide/abi.rst (ou
+   ``Documentation/ABI/README``) para mais informações.
+   Patches que alteram interfaces de espaço de usuário devem colocar
+   linux-api@vger.kernel.org em cópia (CC).
+
+6) Se algum ioctl for adicionado pelo patch, atualize também
+   ``Documentation/userspace-api/ioctl/ioctl-number.rst``.
+
+Verifique seu código com ferramentas
+====================================
+
+1) Verifique violações triviais com o verificador de estilo de patches antes
+   da submissão (``scripts/checkpatch.pl``). Você deve ser capaz de justificar
+   todas as violações que permanecerem no seu patch.
+
+2) Verifique limpo com sparse.
+
+3) Use ``make checkstack`` e corrija quaisquer problemas encontrados.
+   Observe que ``checkstack`` não aponta problemas explicitamente, mas qualquer
+   função que use mais de 512 bytes na pilha é candidata a alteração.
+
+Compile seu código
+==================
+
+1) Compila sem problemas:
+
+  a) com as opções ``CONFIG`` aplicáveis ou modificadas como ``=y``, ``=m`` e
+     ``=n``. Sem avisos/erros do ``gcc`` e sem avisos/erros do linker.
+
+  b) Passa em ``allnoconfig`` e ``allmodconfig``.
+
+  c) Compila com sucesso ao usar ``O=builddir``.
+
+  d) Quaisquer alterações em Documentation/ compilam com sucesso sem novos
+     avisos/erros. Use ``make htmldocs`` ou ``make pdfdocs`` para verificar a
+     compilação e corrigir quaisquer problemas.
+
+2) Compila em múltiplas arquiteturas de CPU usando ferramentas locais de
+   compilação cruzada ou alguma outra infraestrutura de build.
+   Observe que testar em arquiteturas com tamanhos de palavra diferentes
+   (32 e 64 bits) e endianidade diferente (big-endian e little-endian) é eficaz para
+   detectar vários problemas de portabilidade causados por falsas suposições
+   sobre intervalo de quantidades representáveis, alinhamento de dados ou
+   endianidade, entre outros.
+
+3) Código recém-adicionado foi compilado com ``gcc -W`` (use
+   ``make KCFLAGS=-W``). Isso gerará muito ruído, mas é bom para encontrar
+   bugs como "warning: comparison between signed and unsigned".
+
+4) Se o código-fonte modificado depende de ou usa qualquer API ou recurso do
+   kernel relacionado aos seguintes símbolos ``Kconfig``, então teste múltiplas
+   compilações com os símbolos ``Kconfig`` relacionados desativados e/ou como
+   ``=m`` (se essa opção estiver disponível) [não todos ao mesmo tempo, apenas
+   várias combinações aleatórias deles]:
+
+   ``CONFIG_SMP``, ``CONFIG_SYSFS``, ``CONFIG_PROC_FS``, ``CONFIG_INPUT``,
+   ``CONFIG_PCI``, ``CONFIG_BLOCK``, ``CONFIG_PM``, ``CONFIG_MAGIC_SYSRQ``,
+   ``CONFIG_NET``, ``CONFIG_INET=n`` (mas este último com ``CONFIG_NET=y``).
+
+Teste seu código
+================
+
+1) Foi testado com ``CONFIG_PREEMPT``, ``CONFIG_DEBUG_PREEMPT``,
+   ``CONFIG_SLUB_DEBUG``, ``CONFIG_DEBUG_PAGEALLOC``, ``CONFIG_DEBUG_MUTEXES``,
+   ``CONFIG_DEBUG_SPINLOCK``, ``CONFIG_DEBUG_ATOMIC_SLEEP``,
+   ``CONFIG_PROVE_RCU`` e ``CONFIG_DEBUG_OBJECTS_RCU_HEAD`` todos ativados
+   simultaneamente.
+
+2) Foi testado em compilação e em tempo de execução com e sem ``CONFIG_SMP`` e
+   ``CONFIG_PREEMPT``.
+
+3) Todos os caminhos de código foram exercitados com todos os recursos do lockdep
+   ativados.
+
+4) Foi verificado com injeção de falhas pelo menos de slab e de alocação de
+   páginas. Veja ``Documentation/fault-injection/``. Se o novo código for
+   substancial, a adição de injeção de falhas específica do subsistema pode ser
+   apropriada.
+
+5) Testado com a tag mais recente da linux-next para garantir que ainda funciona
+   com todos os outros patches enfileirados e várias alterações na VM, VFS e em
+   outros subsistemas.
\ No newline at end of file
-- 
2.55.0.windows.2


                 reply	other threads:[~2026-08-25 19:03 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

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=20260825190348.12701-1-silvapfabio@gmail.com \
    --to=silvapfabio@gmail.com \
    --cc=corbet@lwn.net \
    --cc=danielmaraboo@gmail.com \
    --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