Hola Gallego, > > Todavía no conocí una mejor forma de documentar un sistema que los > > unittests. Los unittests son ejemplos funcionando (y posibles de correr > > en el debugger) de un feature determinado del sistema. Además, la > > estructura de los tests (crear los objetos iniciales, hacer algo, > > comprobar el resultado de ese algo), es una estructura muy interesante > > para la documentación. > > > > ¿Ventajas? Los tests funcionan, y uno se entera inmediatamente cuando un > > test se rompe. Lamentablemente no podemos decir lo mismo de los > > comentarios. > > Bueno, mas o menos, tanto los comentarios como los tests deben tener > mantenimiento. ¿O vos decis que haces los tests una sola vez y nunca mas > los tocas, sólo los corres? ¿Por qué arreglar los tests y no los > comentarios?
Arreglo los tests antes que los comentarios, porque cuando un test no corre veo un rojo en el test-runner... y, como buen XPer, no integro código si tengo rojo el test-runner. > Si cambio un metodo tambien cambio el comentario. Pero cambiás el método o el significado del mensaje? Si cambiás el método porque cambia la implementación, pero el significado del mensaje sigue siendo el mismo, el comentario no cambia (si comentamos mensajes). > Perdon si > soy muy efusivo con esto pero en la practica cotidiana no tengo > problemas de desactualización (sí de duplicación). Yo todo lo contrario, siempre encuentro comentarios desactualizados. > Lo que si estoy de acuerdo es en el poder de los tests, las pocas veces > que los hago, luego, *siempre* me resultan de inmejorable documentación. Si, creo que los tests son una de esas ideas increíblemente simples, pero increíblemente poderosas. > Saludos > GallegO Más saludos, -- Diego --~--~---------~--~----~------------~-------~--~----~ Ha recibido este mensaje porque está suscrito a Grupo "clubSmalltalk" de Grupos de Google. Si quieres publicar en este grupo, envía un mensaje de correo electrónico a [email protected] Para anular la suscripción a este grupo, envíe un mensaje a [EMAIL PROTECTED] Para obtener más opciones, visita este grupo en http://groups-beta.google.com/group/clubSmalltalk?hl=es. -~----------~----~----~----~------~----~------~--~---
