Hola gente, No pensé que este thread iba a ser tan largo :-)
Bueno, antes de decidir si se comentan o no los métodos tendríamos que diferenciar muy bien método de mensaje. ¿Qué es lo que se comenta, el método o el mensaje? ¿Si hay varios métodos que implementan el mismo mensaje, la documentación del mensaje no estaría duplicada? En CLOS uno define por un lado el mensaje, y por otro los métodos que implementan ese mensaje. En Smalltalk, en cambio, uno no define nunca (al menos como yo lo entiendo) los mensajes, sino que uno implementa métodos. ¿So? ¿Comentamos métodos o mensajes? Si se comenta el mensaje, ¿Cómo se administra la duplicación?. Según lo veo yo: Uno NO tendría que documentar métodos (es decir: detalles de implementación) sino que debería escribir el código limpio, que se entienda SIN necesidad de comentarios (hay muchos trucos para eso, y muchos están en el libro de Kent Beck al que hacen referencia). Pero, si documentamos la intención del mensaje, tenemos que administrar la duplicación. Saludos, -- Diego > Bueno, XP nació de conocidos Smalltalkers, y ellos manifiestan que no > es necesario comentar los métodos (si al final nadie lo lee), 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... --~--~---------~--~----~------------~-------~--~----~ 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. -~----------~----~----~----~------~----~------~--~---
