Vamos falar de outro desenvolvedor, fundamental, e esse aqui está comentando seu código.
Até agora, você deve ter me visto comentar em comentários aos nossos scripts.
Por exemplo, bem aqui, adicionei um comentário de booleanos e isso diz ao interpretador Python, ei, isso é um comentário,
não execute isso, é apenas para mim.
Você pode simplesmente ignorá-lo e pular para a linha dois.
E você viu isso.
Simplesmente fiz isso em Python com o sinal.
Assim que o Python vê um sinal de libra, ele adiciona um comentário.
E você também pode fazer isso depois de uma linha.
Posso dizer que isso atribui a uma variável.
E embora isso possa parecer duas linhas, na verdade é apenas a quebra de linha que está acontecendo e
você pode ver que o intérprete ignora completamente esses comentários.
Agora, comentar parece muito, muito simples, mas é um conceito importante.
E se você quer ser um bom programador em todas as línguas, temos comentários.
Mas há dias bons e maneiras ruins de comentar.
E isso é algo que vem com a prática, mas aqui estão algumas diretrizes principais.
Quando você está comentando seu código, a ideia é que você está adicionando comentários valiosos,
ou seja, se eu adicionar um comentário aqui que diz, ei, esta é uma variável de nome de sinal, um valor da força de Andre, um comentário como este
.
Não é muito bom.
Por que é que?
Bem, porque seu código deve ser autoexplicativo, certo?
A ideia é escrevermos um código que seja fácil de ler e de compreender.
Não está tentando ser inteligente.
Em vez disso, deve ser lido como inglês.
E qualquer programador Python saberia disso aqui.
Estamos simplesmente adicionando Andre como um valor de nome.
Estamos atribuindo uma variável e adicionando um comentário como este que é autoexplicativo apenas adiciona confusão ao seu
código.
Portanto, há uma compensação aqui, é bom comentar seu casaco, digamos, se você está trabalhando
em equipes e outros desenvolvedores querem entender seu código, mas você deve se lembrar deste princípio de
que o código é fácil de ler .
O único momento em que você deseja adicionar comentários ao seu código é, bem, quando algo muito, muito importante está
acontecendo, onde pode ser um pouco complexo, você primeiro decide, ei, este código foi escrito de uma forma
que faça sentido?
Por exemplo, se fosse a variável A.
E esta era a variável B.
Bem, isso pode ser muito difícil para alguém entender, então você pode dizer que esta é uma bandeira
legal.
Mas antes de adicionar esse comentário, você quer dizer para si mesmo, talvez meu código seja difícil de ler,
talvez eu deva apenas alterar a variável para é legal para torná-lo mais compreensível.
Agora, isso é algo que você melhora cada vez mais e quer usar comentários como uma ferramenta extra para tornar seu código
compreensível, talvez você escreva um código que daqui a seis meses queira voltar para entender
o que fez.
Mas lembre-se de que mais comentários não significa necessariamente um código melhor.
Você deseja ser conciso e manter as coisas simples, enquanto adiciona comentários apenas quando necessário para ajudar outras pessoas a
entender seu código, não tentando tornar seu código ilegível mais legível.
Exploraremos este tópico e forneceremos conselhos sobre ele ao longo do curso.
Mas lembre-se desse desenvolvedor fundamental, porque você precisará dele ao longo de sua carreira.
A propósito, este artigo aqui tem alguns pontos realmente importantes dos quais eu acho que você realmente vai se beneficiar, especialmente nas práticas
recomendadas de comentários, você pode ler algumas das coisas a fazer e não fazer e o que alguns dos
principais programadores fazem quando comentando.
Eu sei que parece bobo, mas é um conceito importante que a maioria dos cursos negligencia.
Portanto, eu recomendo fortemente que você leia sobre isso.
Vou criar um link para ele nos recursos e até o próximo vídeo.