Tema: code-quality

• Nombrar identificadores para que el código se lea como intención

  Elegir nombres que expresen qué es o qué hace algo en el vocabulario del dominio, con una longitud proporcional a su alcance; evitar codificaciones, abreviaturas y tipos engañosos, y renombrar a medida que mejora la comprensión.

  methodology · es · reviewed · conocimiento a fecha de 2026-09-15

• Nombrar identificadores: según su rol, con el vocabulario del dominio, tan largos como su alcance

  Un nombre dice qué es o qué hace una cosa dentro del dominio, no qué tipo tiene ni cómo está implementada. La longitud crece con el alcance, cada concepto tiene exactamente una palabra, los valores booleanos se leen como una afirmación y las colecciones van en plural. Las convenciones del lenguaje (PEP 8, Effective Go) prevalecen sobre el gusto personal, y renombrar es barato siempre que se haga con herramientas y en un commit propio.

  methodology · es · reviewed · conocimiento a fecha de 2026-09-16

Legible por máquina: JSON