Cita:
|
Empezado por roman
Je, je, bueno. Aún podría seguir argumentando respecto a lo del chasco pero no lo haré porque en realidad- ¿para qué negarlo? -ya me han convencido.
Lo que me gustaría enfatizar y escuchar opiniones es del punto de exigir o no que dicho código esté razonablemente comentado. Incluso, eso se me ocurre ahora, quizá pudiéramos optar por alguno de esos estándares que nos permitiesen generar un listado de las componentes con sus métodos, propiedades, etc.
// Saludos
|
Creo que es mucho pedir, por ejemplo, en mi caso, al principio pongo una breve descripción de para qué sirve o qué hace y luego tan sólo voy comentando el código cuando hay algo que pueda llevar a confusión o que necesite una aclaración para posibles futuras leídas al código.
No creo que muchos hagan una documentación más o menos completa de sus componentes explicando detalladamente cada propiedad, método, etc. ... aunque seguro que hay alguien que lo hace.