2. comentarios
• Nada puede ser tan útil como un
comentario bien colocado.
• Nada puede ser tan perjudicial como un
viejo comentario
• los comentarios son, como mucho, un mal
necesario
3. • El uso adecuado de los comentarios es
compensar nuestra incapacidad para
expresarse en el código.
• Mas exprecion en codigo es menos
comentarios
4. • La verdad solo esta en el codigo
• El codigo malo genera comentarios
5. Buenos comentarios
• El mejor comentario es el que no se
escribe
• Usarlos para describir el return de un
metodo
• Explicar la intencion
• Advertencias
• Todo comments
6. Malos comentarios
• Por lo general son excusas para tener
codigo malo
• dificil de entender
• Comentarios redundantes
8. • Comentarios de ruido
• Marcador de poscicion
• Attributions and Bylines
• Commented-Out Code
• De informacion
Notas do Editor
Los comentarios viejos pierden la relacion con el codigo
los programadores deben ser disciplinados suficiente para mantener a los comentarios en un alto estado de conservación, la relevancia y exactitud.
la fabricación de un código tan claro y expresivo, que no necesita de los comentarios en el primer lugar.
En lugar de gastar su tiempo a escribir los comentarios que explican el lío que has hecho, lo gastan limpiar ese desastre.
Commented-Out Code
Es codigo que esta comentado por personas que no son capaces de borrarlo porque creen que tendra alguna importancia
Ademas que pueden confundir a los que lean el codigo
Informacion mucha, en el lugar incorrecto , no es ovio lo que se quiere decir
