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?

Automação de testes - uma introdução sobre estratégias
Automação de testes - uma introdução sobre estratégiasAutomação de testes - uma introdução sobre estratégias
Automação de testes - uma introdução sobre estratégiasKleitor Franklint Correa Araujo
 
Come creare un progetto eTwinning: consigli per la progettazione
Come creare un progetto eTwinning: consigli per la progettazioneCome creare un progetto eTwinning: consigli per la progettazione
Come creare un progetto eTwinning: consigli per la progettazionealexandra tosi
 
Aula 2 introdução a sistemas distribuídos
Aula 2   introdução a sistemas distribuídosAula 2   introdução a sistemas distribuídos
Aula 2 introdução a sistemas distribuídosEduardo de Lucena Falcão
 
Introdução aos Sistemas Distribuídos
Introdução aos Sistemas DistribuídosIntrodução aos Sistemas Distribuídos
Introdução aos Sistemas DistribuídosFrederico Madeira
 
Code review guidelines
Code review guidelinesCode review guidelines
Code review guidelinesLalit Kale
 
Getting started with Test Driven Development
Getting started with Test Driven DevelopmentGetting started with Test Driven Development
Getting started with Test Driven DevelopmentFerdous Mahmud Shaon
 
Utilizando JMeter para realizar testes de carga em aplicações WEB
Utilizando JMeter para realizar testes de carga em aplicações WEBUtilizando JMeter para realizar testes de carga em aplicações WEB
Utilizando JMeter para realizar testes de carga em aplicações WEBFreedom DayMS
 
How Can Test Data Management Overcome Mainframe Testing Challenges?
How Can Test Data Management Overcome Mainframe Testing Challenges?How Can Test Data Management Overcome Mainframe Testing Challenges?
How Can Test Data Management Overcome Mainframe Testing Challenges?CA Technologies
 
Sistemas Distribuídos - Aula 01
Sistemas Distribuídos - Aula 01Sistemas Distribuídos - Aula 01
Sistemas Distribuídos - Aula 01Arthur Emanuel
 
System testing ppt
System testing pptSystem testing ppt
System testing pptL ESHWAR
 
Aula04 Sistemas Distribuídos - Processos
Aula04 Sistemas Distribuídos - ProcessosAula04 Sistemas Distribuídos - Processos
Aula04 Sistemas Distribuídos - ProcessosMessias Batista
 
Mutexes, Monitores e Semáforos
Mutexes, Monitores e SemáforosMutexes, Monitores e Semáforos
Mutexes, Monitores e SemáforosThiago Poiani
 

Was ist angesagt? (20)

Automação de testes - uma introdução sobre estratégias
Automação de testes - uma introdução sobre estratégiasAutomação de testes - uma introdução sobre estratégias
Automação de testes - uma introdução sobre estratégias
 
Come creare un progetto eTwinning: consigli per la progettazione
Come creare un progetto eTwinning: consigli per la progettazioneCome creare un progetto eTwinning: consigli per la progettazione
Come creare un progetto eTwinning: consigli per la progettazione
 
CMM e CMMI
CMM e CMMICMM e CMMI
CMM e CMMI
 
Aula 2 introdução a sistemas distribuídos
Aula 2   introdução a sistemas distribuídosAula 2   introdução a sistemas distribuídos
Aula 2 introdução a sistemas distribuídos
 
Introdução aos Sistemas Distribuídos
Introdução aos Sistemas DistribuídosIntrodução aos Sistemas Distribuídos
Introdução aos Sistemas Distribuídos
 
Acessando o MySql com o Python
Acessando o MySql com o PythonAcessando o MySql com o Python
Acessando o MySql com o Python
 
Code review guidelines
Code review guidelinesCode review guidelines
Code review guidelines
 
Herramientas Case
Herramientas CaseHerramientas Case
Herramientas Case
 
Qualidade de Software: MPS.BR
Qualidade de Software: MPS.BRQualidade de Software: MPS.BR
Qualidade de Software: MPS.BR
 
Getting started with Test Driven Development
Getting started with Test Driven DevelopmentGetting started with Test Driven Development
Getting started with Test Driven Development
 
Redes2 aula02
Redes2 aula02Redes2 aula02
Redes2 aula02
 
Utilizando JMeter para realizar testes de carga em aplicações WEB
Utilizando JMeter para realizar testes de carga em aplicações WEBUtilizando JMeter para realizar testes de carga em aplicações WEB
Utilizando JMeter para realizar testes de carga em aplicações WEB
 
How Can Test Data Management Overcome Mainframe Testing Challenges?
How Can Test Data Management Overcome Mainframe Testing Challenges?How Can Test Data Management Overcome Mainframe Testing Challenges?
How Can Test Data Management Overcome Mainframe Testing Challenges?
 
Teste de Software - Introdução
Teste de Software - IntroduçãoTeste de Software - Introdução
Teste de Software - Introdução
 
Sistemas Distribuídos - Aula 01
Sistemas Distribuídos - Aula 01Sistemas Distribuídos - Aula 01
Sistemas Distribuídos - Aula 01
 
System testing ppt
System testing pptSystem testing ppt
System testing ppt
 
Aula04 Sistemas Distribuídos - Processos
Aula04 Sistemas Distribuídos - ProcessosAula04 Sistemas Distribuídos - Processos
Aula04 Sistemas Distribuídos - Processos
 
Metodologia de software
Metodologia de softwareMetodologia de software
Metodologia de software
 
Mutexes, Monitores e Semáforos
Mutexes, Monitores e SemáforosMutexes, Monitores e Semáforos
Mutexes, Monitores e Semáforos
 
Modelo incremental
Modelo incrementalModelo incremental
Modelo incremental
 

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