Revisão de mensagens

Linus Torvalds pede que desenvolvedores do kernel melhorem mensagens de commits de merge

Linus Torvalds solicita que mantenedores do kernel Linux utilizem uma voz ativa e direta nas mensagens de commits de merge, visando maior clareza e coesão na documentação.

Linus Torvalds comenta sobre novidades do Bcachefs para kernel Linux 6.6

Recentemente, ao anunciar a segunda versão candidata (rc2) do Linux Kernel 6.12, Linus Torvalds, criador do sistema operacional Linux, fez um pedido importante aos desenvolvedores: melhorar a forma como escrevem as mensagens de commits de merge. Mas o que isso significa para quem não está familiarizado com o processo de desenvolvimento de software?

No contexto do desenvolvimento de software, especialmente em projetos grandes como o Linux, os desenvolvedores fazem mudanças e correções no código constantemente. Para que essas mudanças sejam integradas ao código principal, elas são enviadas na forma de “pull requests” (pedidos de integração). Cada mudança precisa ser documentada por meio de mensagens de commit que explicam o que foi alterado ou corrigido.

Linus Torvalds enfatizou a importância de usar uma linguagem clara e direta nessas mensagens, sugerindo que os desenvolvedores adotem a voz ativa (ex.: “Corrige um erro…”) em vez da voz passiva (ex.: “O erro foi corrigido…”). Ele argumenta que, ao usar uma forma direta e imperativa, como “Corrigir referência nula de ponteiro em…”, a mensagem fica mais clara e fácil de entender.

Ele também explicou que, ao revisar esses pull requests, ele muitas vezes precisa editar as mensagens para que sigam um padrão de coesão, ajustando coisas simples como espaços em branco e a estrutura de bullet points (pontos de lista). No entanto, o uso frequente da voz passiva por alguns desenvolvedores tem aumentado seu trabalho, já que ele precisa reescrever as mensagens para torná-las mais diretas.

Para quem está começando a entender como o desenvolvimento do Linux funciona, é importante saber que essas mensagens são cruciais para documentar o que foi alterado no código. Elas ajudam outros desenvolvedores a entenderem rapidamente quais mudanças foram feitas, especialmente em momentos de “janelas de merge” — períodos em que grandes quantidades de novas funcionalidades e correções são integradas ao projeto. Quando essas mensagens não são consistentes, pode ser mais difícil para outros contribuidores e revisores entenderem as mudanças, o que pode atrasar o desenvolvimento ou introduzir erros.

Torvalds finalizou seu pedido destacando que, embora a mudança pareça pequena, ela faz uma grande diferença na coesão das mensagens de commits. Ele encorajou todos os desenvolvedores do kernel a adotarem essa prática para facilitar a comunicação e melhorar a eficiência do projeto.

Para mais detalhes sobre o comunicado de Linus Torvalds, o link para a lista de discussão está disponível aqui.