Bem claro que tem que comentar os códigos... imaginem uma dll que é chamada e está escrita dll.dll(Mas deferia ter um nome perfeito na dll, nem a constituição com mais de 500 deputados e acessores consegue deixar claro tem centenas de interpretações e querem que deixe claro o que faz uma dll com milhares de linhas com um nome?)
Ai chama a dll e faz um título mínimo para dll que ficou claro só para vc naquele dia daqui a 30 anos que trabalhei em várias empresas grandes e tenho códigos com mais de 30 anos... vou lá ver o que a dll.dll que eu pequei de um outro que fez ela a 50 anos atrás e não pode ser substituída faz, e sem nenhum comentário, volta para o mundo real.
Pior é uns que querem que eu leia 30 mil linhas de código para depois falar hummm esse código faz isso, era outro que deveria ter lido... se tivesse um resumo do código explicando no início...