esconder um codigo ruim. Lembra do exemplo dado acima ?Date d;Esse codigo ja esta ruim, de nada adianta eu mudar para:Date d; //dia da semanaEsse comentario nao ira se propagar para todo o codigo e sempre que voce se deparar com uma linha como:d.after(d2);Voce vai continuar nao entendendo o proposito do codigo. Podemos tentar colocar uma regra nisso. Concorda que quando se comenta um codigo pode ser que o mesmo precise ser refatorado ? Lembra dos exemplos anteriores onde d passou a ser diaDaSemana ? Com essa mudanca seu codigo passa a ser um codigo que pode ser entendido por todos e se fizermos essa refatoracao o codigo passa a nao precisar mais de comentario.Vamos imaginar um outro exemplo.//Verifica se o usuario tem direito ao beneficioif(usuario.getIdade() > 10 && usuario.getIdade() < 20){ ....}Nao seria melhor:if(isUsuarioTemDireitoAoBeneficio(usuario)){ ....}private boolean isUsuarioTemDireitoAoBeneficio(Usuario usuario){ if(usuario.getIdade() > 10 && usuario.getIdade() < 20){ return true; } return false;}Reparem que tiramos o comentario, melhoramos o codigo e tornamos o mesmo mais legivel. So lendo o codigo agora voce consegue saber o que realmente ele faz.Outro tipo de comentario totalmente inutil e:private boolean isUsuarioTemDireitoAoBeneficio(Usuario usuario){ if(usuario.getIdade() > 10 && usuario.getIdade() < 20){ return true; //Retorna verdadeiro } return false; //Retorna falso}O return do metodo e logico, nao ha necessidade de indicar o que o mesmo esta retornando. Esses tipos de comentario tambem sao desnecessarios.Em relacao a comentarios o Uncle Bob fala:Qualquer comentario que faca voce olhar para outras partes do seu codigo para entende-lo, nao valem os bits que consomem.Em regra geral o ideal e nao comentar uma vez que as pessoas tem medo para excluir comentarios dos codigos e muitas vezes seu codigo pode ficar melhor sem esses comentarios.Mas ai voce pergunta: Nao vou comentar nunca ???Existem horas que comentario e importante. Digamos que voce tenha um trecho em seu codigo que vai demandar um tempo de processamento alto, ou a disponibilidade de um recurso e etc. Nesses casos comentario acaba sendo util. Algumas vezes tambem nao se consegue colocar um nome em um metodo que explique o porque o desenvolvedor tomou aquela decisao, nesses casos utilizar um comentario nao e de todo ruim.FormatacaoFormatacao e importante pois se trata de comunicacao.Temos que pensar que o codigo e a maneira que vamos nos comunicar (nos desenvolvedores). Uma pessoa nao gostaria de receber uma carta cifrada onde tivesse que interpretar o que nela esta escrito, podemos pensar assim na hora de escrever um codigo.Imagine ler o seguinte texto:Fui a praia com minha namorada e comprei agua e sentei na areia e depois de muitas horas joguei frescobol e sai de la as 18h para ir pra casa e cheguei em casa e tomei banho e fui comer alguma coisa e minha mae veio falar comigo que nao era para eu dormir tarde porque eu tinha aula no dia seguinte.Se voce tentar ler isso em voz alta voce provavelmente sentira falta de ar. Por que acentuamos as fases ? Exatamente para formatarmos essa leitura. Nao fica mais facil ler dessa forma:Fui a praia com minha namorada, comprei agua e sentei na areia. Depois