Parlons d'un autre développeur, fondamental, et celui-ci commente votre code.
Jusqu'à présent, vous m'avez peut-être vu commenter les commentaires sur nos scripts.
Par exemple, juste ici, j'ai ajouté un commentaire de booléens, et cela dit à l'interpréteur Python, hé, ceci est un
commentaire, ne l'exécutez pas, c'est juste pour moi.
Vous pouvez simplement l'ignorer et passer à la ligne deux.
Et tu as vu ça.
Je l'ai simplement fait en Python avec le signe.
Dès que Python voit un signe dièse, il ajoute un commentaire.
Et vous pouvez également le faire après une ligne.
Je peux dire que cela affecte une variable.
Et bien que cela puisse ressembler à deux lignes, c'est en fait juste le mot qui se passe
et vous pouvez voir que l'interpréteur ignore complètement ces commentaires.
Maintenant, commenter semble très, très simple, mais c'est un concept important.
Et si vous voulez être un bon programmeur dans toutes les langues, nous avons des commentaires.
Mais il y a de bons jours et de mauvaises façons de commenter.
Et c'est quelque chose qui vient avec la pratique, mais voici quelques lignes directrices clés.
Lorsque vous commentez votre code, l'idée est que vous ajoutez des commentaires précieux,
c'est-à-dire que si j'ajoute un commentaire ici qui dit, hé, c'est une variable de nom de signe, une valeur de force d'André, un commentaire comme celui-ci
.
N'est-ce pas vraiment bon.
Pourquoi donc?
Eh bien, parce que votre code devrait être explicite, n'est-ce pas ?
L'idée est que nous écrivions un code facile à lire, facile à comprendre.
Ce n'est pas essayer d'être intelligent.
Au lieu de cela, il devrait se lire comme l'anglais.
Et tout programmeur Python le saurait ici.
Nous ajoutons simplement Andre comme valeur de nom.
Nous attribuons une variable et ajoutons un commentaire comme celui-ci qui se passe d'explications ne fait qu'encombrer votre
code.
Il y a donc un compromis ici, il est bon de commenter votre manteau car, disons, si vous
travaillez en équipe et que d'autres développeurs viennent et qu'ils veulent comprendre votre code, mais vous devez vous rappeler que
ce principe de code est facile à lire .
La seule fois où vous voulez ajouter des commentaires à votre code, c'est quand quelque chose de vraiment, vraiment important se
passe, où cela peut être un peu complexe, vous décidez d'abord, hé, ce code est-il écrit d'une manière qui
a du sens ?
Par exemple, s'il s'agissait de la variable A.
Et c'était la variable B.
Eh bien, cela pourrait être très difficile à comprendre pour quelqu'un, alors vous pourriez dire que c'est un drapeau
cool.
Mais avant d'ajouter ce commentaire, vous voulez vous dire, peut-être que mon code est difficile à lire, peut-être que
je devrais simplement changer la variable en est cool pour le rendre plus compréhensible.
Maintenant, c'est quelque chose que vous améliorez de plus en plus et vous voulez utiliser les commentaires comme un outil supplémentaire pour rendre votre code
compréhensible, peut-être que vous écrivez du code que dans six mois vous voulez revenir pour comprendre ce
que vous avez fait.
Mais rappelez-vous, plus de commentaires ne signifie pas nécessairement un meilleur code.
Vous voulez être concis et garder les choses simples tout en ajoutant des commentaires uniquement lorsque cela est nécessaire pour aider les autres
à comprendre votre code, sans essayer de rendre votre code illisible plus lisible.
Nous explorerons ce sujet et vous donnerons des conseils tout au long du cours.
Mais rappelez-vous ce fondamental développeur clé car vous allez en avoir besoin tout au long de votre carrière.
Soit dit en passant, cet article ici contient des points très importants dont je pense que vous bénéficierez vraiment, en particulier dans les meilleures pratiques
de commentaires, vous pouvez lire certaines des choses à faire et à ne pas faire et ce que certains des
meilleurs programmeurs font quand commenter.
Je sais que cela semble idiot, mais c'est un concept important que la plupart des cours négligent.
Je vous recommande donc fortement de lire ceci.
Je vais y faire un lien dans les ressources et je vous verrai dans la prochaine vidéo.