Código Limpio
¿Para qué?
- Calidad.
- Costos.
- Documentación.
- Agilidad de proceso.
- Reducir dolores de cabeza.
Nuestro cerebro es un compilador
En promedio puede procesar 7 cosas al mismo tiempo #7Rule
Los developers somos autores
Y tú . . . ¿Cómo capturas a tus nuevos lectores?
¿Qué características buscas en una obra literaria?
Los nombres
¡Sí importan!
-
Evitan desinformación
-
Facilitan búsquedas
-
Significado claro
"El nombre de un método debe decirlo todo."
"Un nombre descriptivo extenso es mucho mejor que uno breve pero enigmático."
"Evite ser chistoso."
X
O
Booleanos
Siempre deben responder una pregunta.
X
O
$wiwi
$isActive
$isNotLoggedIn
$loggedIn
Condicionales
-
Usar la herramienta correcta.
-
Evitar condicionales complejas.
-
Usar indentación clara.
-
A veces el código no es la respuesta.
¿Qué pregunta estas tratando de responder?
No duplicar
"Menos es más."
Buscar patrones de diseño
"No reinventar la rueda."
Razones para crear una función
-
Extraer un método.
-
Unica responsabilidad.
-
"Regresar" pronto.
-
Fallar rapido
"Una función simple puede ser larga."
"Una función compleja debe ser corta."
Fallar rapido
-
No recuperables
-
Recuperables.
-
Ignoradas
Tipos de excepciones
Regresar/Fallar
"pronto"
Debemos recordar
No esperar más de 2 parámetros en una función.
#7Rule
Hablemos de documentación. . .
Comentarios
"Es preferible código expresivo a comentarios"
En php 7 ya se puede usar " type hinting"
MATA el código Zombie
Comenta si y solo si no se puede expresar en el código.
O
// TODO;
¿Cómo mejorar los proyectos colaborativos?
-
Revisión de código.
-
Establecer guías.
-
Hacer pruebas unitarias.
-
Promover de manera proactiva las lineas limpias. (espacios, indentación, nombres . . .)
-
Trabajar en pares
Reconocer el código limpio no significa que sepamos cómo crearlo. . .
Refactorización
La regla del Boy Scout
"Dejar el acampamento más limpio de lo que se ha encontrado."
