Nuestro código habla, cuando programamos estamos escribiendo un mensaje. Hay quien piensa que ese mensaje está destinado únicamente a la máquina, pero hay una parte muy importante de ese mensaje destinado a nosotros mismos. Ya sea para nuestro yo del futuro o o para cualquier otra persona, nuestro código puede comunicarse con nosotros de formas muy diferentes. Muchas veces no somos capaces de entender los mensajes que dejamos escritos en el pasado, otras veces parece que estamos jugando a la búsqueda del tesoro o al escondite. El objetivo de esta sesión es explorar distintas opciones para que entender nuestro código no nos parezca una gymkhana

1. Nuestro código habla,
¿Qué nos dice?
MADRID · NOV 18-19 · 2016

2. Modesto San Juan
@msanjuan
MADRID · NOV 18-19 · 2016

3. Contexto

4. Este podría ser tu próximo compañero

5. “Hay que tocar ese código de hace 6 meses”

6. Tu yo del futuro te lo agradecerá

7. ¿Qué podemos hacer?
• Estructura
• API
• Código
• Tests
• Datos
• Monitorización
• Historia

8. Estructura

9. Estructura

10. Estructura

11. Estructura

12. Estructura

13. Estructura

14. Tu API es una puerta a tu negocio

15. APIs
• Mínima sorpresa
• Códigos de retorno adecuados
• Verbos adecuados
• Tests
• Datos
• Monitorización

16. APIs: mínima sorpresa
/tasks/1/status /tasks/1/status /tasks/1/detail /tasks/1/errors

17. Código
Lenguaje del negocio
Arquitectura hexagonal*
Abstracciones correctas
Niveles de abstracción
Singleton
Tight Coupling
Untestability
Premature optimization
Indescriptible naming
Duplication
Single Responsibility
Open/Close
Liskov Substitution
Interface Segregation
Dependency Inversion

18. “Duplication is far
cheaper than the wrong
abstraction”
Sandy Metz

19. Falta de abstracciones: Primitivos voladores

20. Código

21. Tests
Deben hablar de funcionalidades
En el lenguaje del dominio
Legibles
Simples
VS

22. Datos
BBDD
Devops
Configuración
Parametrización
...

23. Una vez desplegado...

25. ¿Monitorización?

26. Identificación de errores

27. Reproducción de errores

28. Toma de decisiones...

29. Proactivo vs Reactivo

30. ¡Sin pasarse!

31. Historia
¿Dónde pongo el foco?
Silos de conocimiento
Acoplamientos inesperados
…

32. En resumen
Estructura
API
Código (incluyendo DevOps!)
Datos (BBDD, configuración,
parametrización)
Monitorización
Historia
Naming! Siempre Naming!

33. Gracias!