Executando verificação de segurança...
1

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!

Carregando publicação patrocinada...
1

Opa, estou ciente de que uma quantidade exagerada de comentários é realmente, huum, como posso dizer, errado? Bom, posso afirmar que vai de contra a proposta de ajudar.

Entretanto, eu não comento absolutamente nada em código. Então comentários estratégicos, pode ser interessante.

Sobre o padrão, eu já utilizo. Eu sempre tento padronizar nome de funções com o prefixo Handle seguido do que faz, algo como HandlePaste. Nesse sentido, aplico o mesmo em outras partes do código.