código limpo: comentários

14
Comentários Código Limpo Capítulo 4

Upload: inael-rodrigues

Post on 06-Jun-2015

484 views

Category:

Technology


1 download

TRANSCRIPT

Page 1: Código limpo:   Comentários

ComentáriosCódigo Limpo

Capítulo 4

Page 2: Código limpo:   Comentários

Comentários

● “Don’t comment bad code—rewrite it.”;● Se precisa de comentários, revise o código e

tente expressá-lo através dele;● Fontes de imprecisão

Page 3: Código limpo:   Comentários

Cuidados

● Vida útil do comentário;○ Comentário que não é atualizado juntamente com as

mudanças que ocorrem no código.● Localização do comentário;

Page 4: Código limpo:   Comentários

Comentários

Comentários Compensam um Código Ruim

// Verifica se o funcionário tem direito a todos os beneficios

if ((empregado.flags & HOURLY_FLAG) && (empregado.age > 65))

if (empregado.isElegivelParaTodosBeneficios)

Page 5: Código limpo:   Comentários

E onde o comentário é BOM?

● Questões legais; (Direitos autorais)● Comentários informativos;

○ Funções○ Patterns

● Explicação da Intenção;● Esclarecimento; (assertTrue(a.compareTo(a) == 0); //a==a)● Alerta sobre consequências;● Comentário TODO;● Destaque;● JavaDoc e outras API's.

Page 6: Código limpo:   Comentários

Comentários Ruins

● Murmúrios;

Page 7: Código limpo:   Comentários

Comentários Ruins

Page 8: Código limpo:   Comentários

Comentários Ruins

● Comentários enganadores;Criam confusão em relação a função do

código.● Comentários imperativos;

Page 9: Código limpo:   Comentários

Comentários Ruins

● Comentários longos;Deve-se evitar códigos muitos longos

Page 10: Código limpo:   Comentários

Comentários Ruins

● Comentários ruidosos;

Page 11: Código limpo:   Comentários

Comentários Ruins

● Marcadores de posição;

● Comentários nas chaves de fechamento;

Page 12: Código limpo:   Comentários

Comentários Ruins

● Créditos de autoria

Page 13: Código limpo:   Comentários

Comentários Ruins

● Explicar código em comentários;● Comentários HTML;● Informações não locais;● Informações excessivas;● Conexões não obvias;● Cabeçalhos de funções;● Java docs em códigos não públicos;

Page 14: Código limpo:   Comentários

Dúvidas!

?