Dragon Ball Clean Code - Nombres que se puedan pronunciar
Más recomendaciones de Uncle Bob, poner nombres que se puedan pronunciar.
¿Por qué esto es importante? Porque no siempre somos un lobo/a solitario/a que pica código que no ha de rendir cuentas a nadie.
El desarrollo de software tiene muuuuuchooooo de trabajo en equipo (si no lo sabías, después de leer el Clean Code infórmate cómo mejorar soft-skills, será una gran inversión #trustme).
Tenemos que hablar con compañeros, exponer al equipo, explicar un desarrollo a un proveedor externo que no tenga todavía el conocimiento báscico del proyecto… en definitiva, comunicar, comunicar y comunicar.
Dragon Ball Clean code - Distinciones con sentido
En Clean Code de Robert C. Martin se nos recomienda encarecidamente nombrar de forma correcta clases, funciones, variables…
En ocasiones nos encontramos con múltiples variables o funciones que continenen o hacen cosas parecidas y sin pensarlo mucho les damos nombres similares, demasiado similares:
getGod() getGods() getGodList() getGodInfo() getGodData() getGodObject() getTheGod() getAGod() En Dragon Ball hay Dioses para todos los gustos:
El Dios de la Tierra (que es un extraterrestre de color verde) El Dios del cuadrante Norte del Universo (Kaito de toda la vida) El Dios de Dioses (Dios de los 4 dioses de los 4 cuadrantes) Los Dioses supremos (los Kaioshin y sus pendientes Pothala) Hay distintos rangos de Kaioshins y los hay especializados como la Kaioh del Tiempo Dioses de la destrucción (uno por cada Universo!
Dragon Ball Clean Code - Desinformación
Otra recomendación de Uncle Bob para dar buenos nombres a variables y funciones es: no utilizar nombres con variaciones mínimas.
Sobretodo ahora que los IDEs modernos lo autocompletan todo.
Mira este ejemplo:
findDragonBall() findDragonBalls() findDragonBells() findDragonWithBalls() findDragonWithBalletSlippers() Los nombres son descriptivos, pero he acabado con un montón de funciones con nombre muy similar y esto es un problema.
El siguiente código está sacado del radar de Dragon Balls de Bulma:
Dragon Ball Clean code - Nombre de variables
En el libro de Clean Code de Robert C. Martin (Uncle Bob) nos recomienda que las variables deben tener un buen nombre, un nombre que revele las intenciones de nuestro código.
No se trata sólo de que el nombre sea acorde al contenido de la variable, si no que hay que buscar la intención.
Mira este trozo de código:
public boolean isSS(int r, int hc, int e) { if (r !