Please enable JavaScript.
Coggle requires JavaScript to display documents.
Comentários - Coggle Diagram
Comentários
Muito útil quando bem colocado
Quando não conseguimos nos expressar só com o código
Não é motivo de comemoração
É um fracasso
Bons comentários
Comentários legais
Comentários informativos
Comentários que explicam a intenção
Comentários de esclareciamento
Comentários que alertam das consequencias
TODOs
Tipo javadoc em APIs públicas
Correm um grade risco de ficar desatualizado
A única verdade é o código
Programadores não conseguem manter atualizado
Não compensam código ruim
O esforço deve ser alocado para melhorar o código
Explique-se no código
Nomes melhores
Funções menores
Modulos com uma unica responsabilidade
Muito prejudicial quando errado ou mal feito
Comentários Ruins
Murmurio
Redundantes
Enganadores
Imperativos
Longos
Ruidosos
Marcadores de posição ou em chaves de fechamento
Crédito das alterações
Códigos comentádos
Comentários com HTML
Informações excessivas
Informações não-locais
Tipo javadoc em apis não-publicas