>Hola ST'ers:
Hola Esteban.
>Hay algún guideline acerca de como comentar los métodos de
>cada objeto?
Hola Esteban.
>Hay algún guideline acerca de como comentar los métodos de
>cada objeto?
Kent Beck dice que menos del 1 por ciento de su código tiene comentarios. =0
(Best Practice Smalltalk Patterns, creo. Es de lo mejor).
La idea es que el método se explique a sí mismo.
Yo no creo que haya que ser tan extremista como el amigo Kent, porque es desalentador encontrarse con código sin ninguna documentación, que hay mucho dando vueltas. Me parece que una buena explicación en el comentario de la clase sirve para la mayoría de los casos.
Ni hablar que los accessors no requieren ningún comentario, más bien molestan. Lo que es bueno es saber para qué están las variables a las que acceden, y eso queda mejor en el comentario general, para que uno se dé una idea de la totalidad.
En ese libro también habla mucho sobre como nombrar los métodos y las clases.
Saludos
Norberto Manzanos
CAICYT
CAICYT
Sin conexión 
Enviar correo