Executando verificação de segurança...
Em resposta a [Não disponível]
3

Complementando, alguns meses atrás já teve uma discussão sobre isso.

Basicamente a ideia levantada lá é a mesma: comentários óbvios demais acabam poluindo o código e não acrescentando nenhum valor de fato. O melhor é explicar porque algo foi feito, em vez de ser redundante e só repetir com palavras o que o código faz.

Carregando publicação patrocinada...
2

Concordo totalmente contigo, mas tem gente que ainda discorda disso aí e acha que não deve ter comentário nenhum. Nem mesmo explicando uma regra de negócio envolvida/exemplo do dado a ser preenchido/qual endpoint obter o dado, etc.
As pessoas estão cegas, seguindo mantras a todo custo e repetem. O "não pode ter comentário" é com certeza o mesmo que "não pode colocar // nem /** */, nenhum tipo de comentário mesmo! Mesmo que isso seja útil."

3

Esse é um fenômeno comum na nossa área, não só para comentários, mas para qualquer coisa.

Alguém diz "Nunca faça X!" e para justificar usa como exemplos somente casos em que X é ruim, não é a melhor opção, ou claramente não serve. E claro, ignora os casos em que X é a melhor solução (seja de propósito, ou por desconhecimento). Ou o contrário, diz pra sempre usar algo, mesmo quando não é a melhor solução.

É assim com o pessoal do "não use if", "não use herança", "use flexbox", "use micro-serviços", ou seja lá qual for a moda ou o meme do dia.

Mas não é assim que funciona. A grande maioria das coisas - senão tudo - tem prós e contras, situações em que elas são mais adequadas e casos em que não são a melhor opção (e podem até piorar tudo). Com comentários não é diferente.