Este documento ofrece consejos para escribir código de alta calidad, incluyendo usar nombres semánticos para variables y métodos, documentar y alinear el código según los estándares, escribir comentarios y documentación útiles en inglés, y utilizar herramientas como testing y code review. También enfatiza la importancia de la humildad y de aprender de los errores.
2. Premisas del juego
Nos ponemos en la piel de la comunidad!
Vamos a juzgar el trabajo de los demás de
forma completamente objetiva!
No son nuestros amigos, no les debemos
respeto.!
Vamos a jugar a ser Dios.
13. Premisas del juego
Nuestro trabajo será juzgado por “la
comunidad”. Siempre!!
“La comunidad” puede ser el desarrollado
que 2 años después, siga trabajando el código
que antaño empezaste tu.!
“Y quien mierdas hizo esta basura?” - Dijo
Flipencio
14. Esto es una basura!
public function aaaaaa($a, $b)!
{!
$a += $b+($a-b); //die;!
$b -= $a; // ui si, no se que…!
!
//echo $a;!
!
if ($a) $b = 1; else!
$b =0; return; }!
24. /**!
* Method that calculates maximum value between two values.!
*!
* @param float $value1 First value!
* @param float $value2 Second value!
*!
* @return float Maximum between both values!
*/!
public function maximum($value1, $value2)!
{!
! $result = ($value1 >= $value2) !
! ! ? $value1!
! ! : $value2;!
!
! return $result;!
}
25. /**!
* Metodo kiu kalkulas maksimuma valoro inter du valoroj.!
*!
* @param float $valoro1 Unua valoro!
* @param float $valoro2 Dua valoro!
*!
* @return float Maksimuma inter ambaŭ valoroj!
*/!
public function maksimuma($valoro1, $valoro2)!
{!
! $rezulto = ($valoro1 >= $valoro2) !
! ! ? $valoro1!
! ! : $valoro2;!
!
! return $rezulto;!
}
26. Esto es lo que pasa
Cuando se utiliza el español en el código…%
APOCALIPSIS !!!
27. Nota importante
Evitar comentarios estúpidos: “Ui si, no se
que, soy un código y funciono cacho guay”!
Evitar testing comentado: “echo(‘engonga’) !
Evitar comunicaciones con el futuro:
“Querido developer. Siento la mierda que te
has encontrado, pero basicamente… no sabía
hacerlo mejor…”
28. Nota importante
Evitar documentación obvia: “Este código
hace algo”!
Evitar escribir vuestras vidas: “Querido
diario… “!
Y sobretodo… “Este código está hecho fatal,
pero funciona”… por el amor de Dios!
Despedido! Fuera! Y no vuelvas!
29. Consejos de éxito
Herramientas de calidad!
Testing!
Compromiso con vuestra
obra. Es vuestro reflejo.!
Pair programing!
Code review