Please enable JavaScript.
Coggle requires JavaScript to display documents.
04 - COMENTÁRIOS (DESENCORAJADO (Comentar com pressa (TODO para melhorar),…
04 - COMENTÁRIOS
DESENCORAJADO
Comentar com pressa (TODO para melhorar)
Redundância
Falta de clareza e fidelidade
Não acrescenta relefvância
Histórico de alterações
Blocos de fechamento
Explicar códigos
Informações excessivas
JavaDocs APIs privadas
Marcações (decomponha ou modularize)
RECOMENDAÇÕES
Código expressivo melhor que comentário
Decomponha em vez de comentar finais de blocos
Informações legais (licença)
EXPLICAR
Formatos de expressões regulares
Intenção por trás do código
Código que não pode ser alterado
TODOs
Destacar aparente irrelevância
JavaDocs APIs públicas
Avisos (teste de execução demorada)
PERIGOS
Mais antigo, mais mentiroso
Usado para compensar código ruim
Raramente são atualizados