SlideShare ist ein Scribd-Unternehmen logo
1 von 8
David Pineda Moncada
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
• El uso adecuado de los comentarios es
compensar nuestra incapacidad para
expresarse en el código.
• Mas exprecion en codigo es menos
comentarios
• 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
• Explicar la intencion
• Advertencias
• Todo comments
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

Weitere ähnliche Inhalte

Was ist angesagt?

A simple formula for becoming Lean, Agile and unlocking high performance team...
A simple formula for becoming Lean, Agile and unlocking high performance team...A simple formula for becoming Lean, Agile and unlocking high performance team...
A simple formula for becoming Lean, Agile and unlocking high performance team...Rowan Bunning
 
Introduction to Agile Software Development
Introduction to Agile Software DevelopmentIntroduction to Agile Software Development
Introduction to Agile Software DevelopmentLife Cycle Engineering
 
GDG Cloud Southlake #2 Jez Humble DevOps Transformation:Building & Scaling H...
 GDG Cloud Southlake #2 Jez Humble DevOps Transformation:Building & Scaling H... GDG Cloud Southlake #2 Jez Humble DevOps Transformation:Building & Scaling H...
GDG Cloud Southlake #2 Jez Humble DevOps Transformation:Building & Scaling H...James Anderson
 
Scrumban Demystified
Scrumban DemystifiedScrumban Demystified
Scrumban DemystifiedJack Speranza
 
Alineamiento Estratégico con OKRs - OKR Summit (Chile 2020)
Alineamiento Estratégico con OKRs - OKR Summit (Chile 2020)Alineamiento Estratégico con OKRs - OKR Summit (Chile 2020)
Alineamiento Estratégico con OKRs - OKR Summit (Chile 2020)Johnny Ordóñez
 
DevOps Tutorial For Beginners | DevOps Tutorial | DevOps Tools | DevOps Train...
DevOps Tutorial For Beginners | DevOps Tutorial | DevOps Tools | DevOps Train...DevOps Tutorial For Beginners | DevOps Tutorial | DevOps Tools | DevOps Train...
DevOps Tutorial For Beginners | DevOps Tutorial | DevOps Tools | DevOps Train...Simplilearn
 
Building Agile Teams agile Prague 2022.pdf
Building Agile Teams agile Prague 2022.pdfBuilding Agile Teams agile Prague 2022.pdf
Building Agile Teams agile Prague 2022.pdfAngel Diaz-Maroto
 
Software Craftsmanship and Agile Code Games
Software Craftsmanship and Agile Code GamesSoftware Craftsmanship and Agile Code Games
Software Craftsmanship and Agile Code GamesMike Clement
 
Introdução ao Domain-Driven Design
Introdução ao Domain-Driven DesignIntrodução ao Domain-Driven Design
Introdução ao Domain-Driven DesignAndré Borgonovo
 
The Road To Technical Team Lead
The Road To Technical Team LeadThe Road To Technical Team Lead
The Road To Technical Team Leadbenwaine
 
Il était une fois la vie d'un Product Owner
Il était une fois la vie d'un Product OwnerIl était une fois la vie d'un Product Owner
Il était une fois la vie d'un Product OwnerRomain Couturier
 

Was ist angesagt? (20)

A simple formula for becoming Lean, Agile and unlocking high performance team...
A simple formula for becoming Lean, Agile and unlocking high performance team...A simple formula for becoming Lean, Agile and unlocking high performance team...
A simple formula for becoming Lean, Agile and unlocking high performance team...
 
PNL.pdf
PNL.pdfPNL.pdf
PNL.pdf
 
Introduction to Agile Software Development
Introduction to Agile Software DevelopmentIntroduction to Agile Software Development
Introduction to Agile Software Development
 
GDG Cloud Southlake #2 Jez Humble DevOps Transformation:Building & Scaling H...
 GDG Cloud Southlake #2 Jez Humble DevOps Transformation:Building & Scaling H... GDG Cloud Southlake #2 Jez Humble DevOps Transformation:Building & Scaling H...
GDG Cloud Southlake #2 Jez Humble DevOps Transformation:Building & Scaling H...
 
Scrumban Demystified
Scrumban DemystifiedScrumban Demystified
Scrumban Demystified
 
1ra presentacion metodologias agiles
1ra presentacion metodologias agiles1ra presentacion metodologias agiles
1ra presentacion metodologias agiles
 
Alineamiento Estratégico con OKRs - OKR Summit (Chile 2020)
Alineamiento Estratégico con OKRs - OKR Summit (Chile 2020)Alineamiento Estratégico con OKRs - OKR Summit (Chile 2020)
Alineamiento Estratégico con OKRs - OKR Summit (Chile 2020)
 
DevOps Tutorial For Beginners | DevOps Tutorial | DevOps Tools | DevOps Train...
DevOps Tutorial For Beginners | DevOps Tutorial | DevOps Tools | DevOps Train...DevOps Tutorial For Beginners | DevOps Tutorial | DevOps Tools | DevOps Train...
DevOps Tutorial For Beginners | DevOps Tutorial | DevOps Tools | DevOps Train...
 
Building Agile Teams agile Prague 2022.pdf
Building Agile Teams agile Prague 2022.pdfBuilding Agile Teams agile Prague 2022.pdf
Building Agile Teams agile Prague 2022.pdf
 
Metricas
MetricasMetricas
Metricas
 
Agile Mindset
Agile MindsetAgile Mindset
Agile Mindset
 
DevOps.pptx
DevOps.pptxDevOps.pptx
DevOps.pptx
 
Software Craftsmanship and Agile Code Games
Software Craftsmanship and Agile Code GamesSoftware Craftsmanship and Agile Code Games
Software Craftsmanship and Agile Code Games
 
Clean code en pratique
Clean code en pratiqueClean code en pratique
Clean code en pratique
 
Introdução ao Domain-Driven Design
Introdução ao Domain-Driven DesignIntrodução ao Domain-Driven Design
Introdução ao Domain-Driven Design
 
The Road To Technical Team Lead
The Road To Technical Team LeadThe Road To Technical Team Lead
The Road To Technical Team Lead
 
Il était une fois la vie d'un Product Owner
Il était une fois la vie d'un Product OwnerIl était une fois la vie d'un Product Owner
Il était une fois la vie d'un Product Owner
 
Gradle vs Maven
Gradle vs MavenGradle vs Maven
Gradle vs Maven
 
DevOps 101
DevOps 101DevOps 101
DevOps 101
 
Agile contracts
Agile contractsAgile contracts
Agile contracts
 

Kürzlich hochgeladen

2da. Clase Mecanografía e introducción a Excel (2).pptx
2da. Clase Mecanografía e introducción a Excel (2).pptx2da. Clase Mecanografía e introducción a Excel (2).pptx
2da. Clase Mecanografía e introducción a Excel (2).pptxEncomiendasElSherpa
 
Caso de éxito de Hervian con el ERP Sage 200
Caso de éxito de Hervian con el ERP Sage 200Caso de éxito de Hervian con el ERP Sage 200
Caso de éxito de Hervian con el ERP Sage 200Opentix
 
Evaluación del riesgo tecnologías informáticas.pdf
Evaluación del riesgo tecnologías informáticas.pdfEvaluación del riesgo tecnologías informáticas.pdf
Evaluación del riesgo tecnologías informáticas.pdfGuillermoBarquero7
 
Trabajo de Powerpoint - Unsaac - Ofimática
Trabajo de Powerpoint - Unsaac - OfimáticaTrabajo de Powerpoint - Unsaac - Ofimática
Trabajo de Powerpoint - Unsaac - OfimáticaKANTUPAULAPORCELYUCR
 
Caso de Exito LPL Projects Logistics Spain y Business Central
Caso de Exito LPL Projects Logistics Spain y Business CentralCaso de Exito LPL Projects Logistics Spain y Business Central
Caso de Exito LPL Projects Logistics Spain y Business CentralAitana
 
ESCRITORIO DE WINDOWS 11 Y SUS ELEMENTOS
ESCRITORIO DE WINDOWS 11 Y SUS ELEMENTOSESCRITORIO DE WINDOWS 11 Y SUS ELEMENTOS
ESCRITORIO DE WINDOWS 11 Y SUS ELEMENTOSBeatrizGonzales19
 

Kürzlich hochgeladen (6)

2da. Clase Mecanografía e introducción a Excel (2).pptx
2da. Clase Mecanografía e introducción a Excel (2).pptx2da. Clase Mecanografía e introducción a Excel (2).pptx
2da. Clase Mecanografía e introducción a Excel (2).pptx
 
Caso de éxito de Hervian con el ERP Sage 200
Caso de éxito de Hervian con el ERP Sage 200Caso de éxito de Hervian con el ERP Sage 200
Caso de éxito de Hervian con el ERP Sage 200
 
Evaluación del riesgo tecnologías informáticas.pdf
Evaluación del riesgo tecnologías informáticas.pdfEvaluación del riesgo tecnologías informáticas.pdf
Evaluación del riesgo tecnologías informáticas.pdf
 
Trabajo de Powerpoint - Unsaac - Ofimática
Trabajo de Powerpoint - Unsaac - OfimáticaTrabajo de Powerpoint - Unsaac - Ofimática
Trabajo de Powerpoint - Unsaac - Ofimática
 
Caso de Exito LPL Projects Logistics Spain y Business Central
Caso de Exito LPL Projects Logistics Spain y Business CentralCaso de Exito LPL Projects Logistics Spain y Business Central
Caso de Exito LPL Projects Logistics Spain y Business Central
 
ESCRITORIO DE WINDOWS 11 Y SUS ELEMENTOS
ESCRITORIO DE WINDOWS 11 Y SUS ELEMENTOSESCRITORIO DE WINDOWS 11 Y SUS ELEMENTOS
ESCRITORIO DE WINDOWS 11 Y SUS ELEMENTOS
 

Clean code capitulo 4("Comments ")

  • 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
  • 7. • comentarios engañosos • Comentarios por mandatos(cada variable ) • Journal Comments
  • 8. • Comentarios de ruido • Marcador de poscicion • Attributions and Bylines • Commented-Out Code • De informacion

Hinweis der Redaktion

  1. Los comentarios viejos pierden la relacion con el codigo
  2. 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.
  3. 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