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

Sem querer botar o meme da bell curve mas já botando...
Também tinha essa ideia de "comentário é pra código ruim". Mas mesmo que seu time todo consiga aderir a linguagem ubíqua e siga a risca o DDD, ainda vão existir varios casos e exceções onde você vai ler o código e vai se perguntar "Beleza, mas qual porque disso?"

Nao necessariamente você vai explicar o código em si, mas as vezes a regra de negócio mais complexa, etc.

Você não odeia comentários em código, você odeia comentários inúteis em código.

Carregando publicação patrocinada...
-7
eliaseas

Para saber o porquê disso sem precisar de um comentário basta usar o git blame, e assim terá a lista de todos os commits que modificaram aquelas linhas.

Aliado a isso, um bom padrão na descrição dos commits como o Conventional Commits vai ajudar a rapidamente identificar as razões daquilo.

6
thedev
Autor
Autor

Depois da uma lida:
https://en.wikipedia.org/wiki/Cognitive_load

Facilite a vida do seu time, nao tente ser esperto.

E btw, o blame vai mostrar apenas a última alteração da linha e não necessariamente o porque original.
Talvez tenha até como pegar a listagem de commits da linha, mas até tu chegar ai o comentário em cima do método ja te poupou 5 minutos.

1