20240519

Clean Code - Comentários

Expresse você mesmo em código e não em comentários


Comentários não são desculpas para nomes ruins 


Use métodos em vez de comentários para segmentar seu código



Escreva comentários para explicar o porquê, e não o quê


O design entra nos documentos de design e não no código



Comente com " e não com *



Coloque comentários antes da declaração a que se referem


Excluir código ao invés de comentá-lo


Não faça versionamento manual


Use FIXME, TODO e XXX e adicione seu ID



Não adicione assinatura de métodos e comentários de fim de linha 



Não duplique os textos das mensagens como comentários