‫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, fácil de entender.
‫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.