Realmente, as pessoas podem pensar o mesmo do meu código. Irei pensar em práticas para diminui isto, como adicionar mais comentários e etc... Não pensei neste ponto. Além disso irei come çar lendo código de projetos menores até me acostumar mais com está prática.
Obrigado pelo o comentário!
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!