por
pobrecito hablador
el Martes, 23 Noviembre de 2004, 11:29h
(#392928)
Una variante de esos comentarios es convertirlos en sentencias de salida (ya sea a base de prints o algo mas elaborado como un servicio de logging).
Retocandolos un poco para que sepas el contenido, "abriendo base de datos '$bd' con usuario '$user'".
A parte de eso, los comentarios mas utiles son los que indican que parametros de entrada, que parametros de salida, que se quiere hacer y que otros modulos se tocan (para evitar posibles efectos laterales). Esto es lo mas basico, basico de cualquier documentacion.
Si notas la profunda estupidez de ese comentario, estás en el camino para entender por qué "Abro una conexión con base de datos", "Cierro el fichero" y similares son comentarios pésimos.
Creo que son ejemplos distintos... a=b*2; es fácil de entender por cualquier persona, pero cuando te pones con fopen y similares quizás no lo sea para todo el mundo... ya estamos hablando de otras cosas.
Yo uso bastantes comentarios, como forma didactica.
--
__________________________________________________
La sabiduría se halla en el buscar... Google power!!!
no siempre, debugging
(Puntos:2, Informativo)Retocandolos un poco para que sepas el contenido, "abriendo base de datos '$bd' con usuario '$user'".
A parte de eso, los comentarios mas utiles son los que indican que parametros de entrada, que parametros de salida, que se quiere hacer y que otros modulos se tocan (para evitar posibles efectos laterales). Esto es lo mas basico, basico de cualquier documentacion.
Re:La pregunta clave
(Puntos:1)( http://ww.google.es/ | Última bitácora: Martes, 01 Mayo de 2007, 16:43h )
Creo que son ejemplos distintos... a=b*2; es fácil de entender por cualquier persona, pero cuando te pones con fopen y similares quizás no lo sea para todo el mundo... ya estamos hablando de otras cosas.
Yo uso bastantes comentarios, como forma didactica.
__________________________________________________
La sabiduría se halla en el buscar... Google power!!!