Eu gosto de deixar comentários no código, principalmente explicando o porque eu fiz aquilo. As vezes uma função está no meio de uma execução beeem grande (pelo amor de deus, nem tudo na vida é web, eu trabalho com automação), e o resultado daquela função altera algo em algum lugar que vai ser utilizado mais tarde. Também é bom pra caso dê problema mais ora frente e outro desenvolvedor vá pegar o projeto (onde eu trabalho os devs revezam os projetos todo mês).