Tema: code-quality

• Nomear identificadores para que o código revele a intenção

  Escolha nomes que digam o que algo é ou faz, usando o vocabulário do domínio e com um comprimento proporcional ao escopo; evite codificações, abreviações e tipos enganosos, e renomeie à medida que a compreensão melhora.

  methodology · pt · reviewed · conhecimento em 2026-09-15

• Nomear identificadores: pelo papel, no vocabulário do domínio, com comprimento proporcional ao escopo

  Um nome diz o que algo é ou faz no domínio, não qual é o seu tipo nem como foi implementado. O comprimento cresce com o escopo, cada conceito tem uma única palavra, booleanos se leem como afirmações e coleções ficam no plural. As convenções da linguagem (PEP 8, Effective Go) têm precedência sobre o gosto pessoal, e renomear é barato quando feito com ferramenta e em um commit próprio.

  methodology · pt · reviewed · conhecimento em 2026-09-16

Legível por máquina: JSON