Explanatory Variables
Variables Explicativas
G19: When a complex expression fills a line, the reader must mentally evaluate it to understand its meaning. Break it into named steps. Each intermediate variable becomes a comment that can't go stale — it is the computation, named. This is especially important for mathematical formulas, regular expressions, and multi-part boolean conditions.
G19: Cuando una expresión compleja llena una línea, el lector debe evaluarla mentalmente para entender su significado. Divídela en pasos nombrados. Cada variable intermedia se convierte en un comentario que no puede quedarse obsoleto — es el cálculo, nombrado. Esto es especialmente importante para fórmulas matemáticas, expresiones regulares y condiciones booleanas de múltiples partes.
Precise Names & Algorithm Understanding
Nombres Precisos y Comprensión del Algoritmo
G20: A function's name is a contract. getUser promises a read with no side effects. If it also logs, caches, and audits, the name is a lie. Use a name that is the complete truth — even if it's longer. G21: Don't stop working on an algorithm when the tests pass. Understand it. Refactor it until you can explain every line. Code you don't fully understand is code you can't safely change.
G20: El nombre de una función es un contrato. getUser promete una lectura sin efectos secundarios. Si también registra, almacena en caché y audita, el nombre es una mentira. Usa un nombre que sea la verdad completa — aunque sea más largo. G21: No dejes de trabajar en un algoritmo cuando las pruebas pasen. Entiéndelo. Refactorízalo hasta que puedas explicar cada línea.
✏️
Code Challenge
Desafío de Código
Break the dense formula into explanatory named variables.
Divide la fórmula densa en variables nombradas explicativas.
💡 Key takeaway
Expressive code is not about being clever — it's about being clear. Name every important intermediate result.
El código expresivo no se trata de ser inteligente — se trata de ser claro. Nombra cada resultado intermedio importante.