Comentários - torne o código compreensível

Comentários são essenciais na programação, pois permitem que lembremos o que determinada linha de código executa, por exemplo.

As vezes iniciamos um projeto e damos continuidade após um determinado intervalo, por qualquer razão. Mas, e se retomamos novamente, é possível lembrar de tudo? Ou se conseguimos resolver um problema num bloco do script, após um tempo, se não houver comentário o programador será capaz de entender o que foi escrito?

Comentários servem também para tornar o código legível/compreensível, além de permitir que outros programadores entendam e contribuam para o seu projeto!

De agora em diante essa será uma ferramenta inseparável sua.

No Python, o símbolo # é utilizado para fazer comentários. Tudo o que vir após este símbolo, o interpretador irá ignorar.

Exemplo:

c = 3
b = 4

#area do retangulo
print (c*b)

Acima, temos o script escrito no editor de texto do Python. Quando executamos o script, o Python retorna:

12

As variáveis foram criadas e o comando da função print foi executado retornando apenas o resultado da multiplicação, ignorando totalmente a linha de comentário com o símbolo #.

Use na medida certa. Procure fazer comentários curtos, objetivos e em casos que determinado trecho do seu código não seja de fácil compreensão.