Olá Araujo! Bem, adicionar mais comentários não torna seu código melhor. O que deve ser feito é melhorar a escrita de código, torná-lo fácil de entender. E isso pode ser feito de algumas formas simples:
- Nomeando funções, variáveis e classes com nomes autoexplicativos (mesmo que eles se tornem longos);
- Criar arquivos separados para diferentes funcionalidades do código;
- Criar funções que realizem apenas uma ação, fazendo o que seu nome realmente diz que ela faz;
- Procurar sempre a melhor forma para resolver o problema.
Essas são apenas algumas formas de tornar o código melhor.
“O uso adequado de comentários é para compensar nossa falha em nos expressar em código.”
Por Robert C. Martin (autor do livro Clean Code)
Óbvio, as vezes é necessário adicionar um comentário em nosso código. Mas sempre que pensar em comentar algo, pense: "O que eu poderia fazer para tornar esse código mais fácil de entender?". Acredite, sempre há uma forma de melhorar o código, mesmo que o processo seja demorado ou cansativo.
Recomendo a leitura dos livros "O guia do mochileiro Python" e "Clean code".
Até mais!