‫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 peut ê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.