David Pineda Moncada
comentarios
• Nada puede ser tan útil como un
comentario bien colocado.
• Nada puede ser tan perjudicial como un
viejo com...
• El uso adecuado de los comentarios es
compensar nuestra incapacidad para
expresarse en el código.
• Mas exprecion en cod...
• La verdad solo esta en el codigo
• El codigo malo genera comentarios
Buenos comentarios
• El mejor comentario es el que no se
escribe
• Usarlos para describir el return de un
metodo
• Explica...
Malos comentarios
• Por lo general son excusas para tener
codigo malo
• dificil de entender
• Comentarios redundantes
• comentarios engañosos
• Comentarios por mandatos(cada variable )
• Journal Comments
• Comentarios de ruido
• Marcador de poscicion
• Attributions and Bylines
• Commented-Out Code
• De informacion
Próxima SlideShare
Cargando en…5
×

Clean code capitulo 4("Comments ")

394 visualizaciones

Publicado el

resumen de lo que se dice en el capitulo 4 de clean code

Publicado en: Software
0 comentarios
1 recomendación
Estadísticas
Notas
  • Sé el primero en comentar

Sin descargas
Visualizaciones
Visualizaciones totales
394
En SlideShare
0
De insertados
0
Número de insertados
214
Acciones
Compartido
0
Descargas
2
Comentarios
0
Recomendaciones
1
Insertados 0
No insertados

No hay notas en la diapositiva.
  • 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
  • Clean code capitulo 4("Comments ")

    1. 1. David Pineda Moncada
    2. 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. 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. 4. • La verdad solo esta en el codigo • El codigo malo genera comentarios
    5. 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. 6. Malos comentarios • Por lo general son excusas para tener codigo malo • dificil de entender • Comentarios redundantes
    7. 7. • comentarios engañosos • Comentarios por mandatos(cada variable ) • Journal Comments
    8. 8. • Comentarios de ruido • Marcador de poscicion • Attributions and Bylines • Commented-Out Code • De informacion

    ×