Hola Gallego, > Guillermo Schwarz escribió: > > Bueno, XP nació de conocidos Smalltalkers, y ellos manifiestan que no es > > necesario comentar los métodos (si al final nadie lo lee), > > Ok, si nadie lo lee quiere decir algo peor aún, están usando cosas sin > prestar atención. En Smalltalk hay que leer mucho, mucho más de lo que > se escribe
Nadie habla si se lee o no, sino de si leemos comentarios o leemos código funcionando. > y por ende escribir un par de comentarios no suele molestar a > nadie. Escribirlo no, pero mantener duplicaciones si que molesta. Y ni hablar lo molesto que es encontrarse un comentario desactualizado. > con las > > siguientes salvedades: > > > > 1. Comentarios de clase. > > 2. Comentarios de interfaces y de clases "fachada". > > > > ¿Cómo se las arreglan sin comentarios? > > > > Intention revealing selectors... > > Me imagino que "Intention revealing selectors" pueden llegar a ser en la > primer semana de escritura, Nombre de selectores, nombre de variables temporales, nombre de clases, comentarios de clase... pero, sobre todo, test-cases que funcionan. 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. > el primer mes, o en una clase de tutorial, > pero en un sistema bastante grande a veces es dificil encontrar > "Intention revealing selectors". En un sistema grande, uno tiene muchos objetos simples. Documentar 1 objeto nunca debiera ser complicado... si lo es, huele a que ese objeto hace demasiado. > No te parece? Más o menos ;-) > Como haces en Java? No se estila usar Java doc ni nada de eso? > > Saludos > GallegO 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. -~----------~----~----~----~------~----~------~--~---
