De la Documentación y Otros Demonios

Las dos cosas que no le gustan a los programadores son escribir pruebas(tests) y documentar. Buen, puede que a los más educados, juiciosos u organizados no les cueste e incluso les guste pero hay quienes sí nos cuesta un poco más.

El tema es que ambas son muy importantes. Los pruebas ayudan a garantizar que tu código en realidad hace lo que tiene que hacer y la documentación permite, en el mediano y largo plazo, que otros puedan leer, entender y usar tu código sin mayores complicaciones. Incluso podría servirte a ti mismo.

Pero, ¿y por qué cuesta tanto hacer ambas si son tan útiles? Creo que es cuestión de desconocimiento de las formas sencillas para lograrlo. Para el caso de los tests es importante escoger el framework o librería que nos permita acostumbrarnos a hacerlo con frecuencia y para documentar usar herramientas que la generen a partir del código fuente. Leer más “De la Documentación y Otros Demonios”

Anuncios