もうひとつの開発者の基本である､ コードへのコメントについて説明しましょう｡
今までは､ 私がコメントしたり､ スクリプトにコメントを加えたりしているのを見たことがあるかもしれません｡
例えば､ ここではブール値のコメントを追加していますが､ これはPythonインタープリタに「おい､ これはコメントだから実行するなよ」と伝えるものです｡
自分のためだけなんです｡
無視して2行目に飛べばいいんです｡
それを見たのか？
それをPythonで単純にポンド記号でやっただけです｡
Pythonはポンド記号を見るとすぐにコメントを追加し､ 行の後にも同じことをすることができます｡
これは変数に代入していると言えますね｡
そして､ これは2行に見えるかもしれませんが､ 実はウォードラップが行われているだけなのです｡
そして､ インタプリタがこれらのコメントを完全に無視していることがおわかりいただけると思います｡
さて､ コメントというととてもシンプルに聞こえますが､ これは重要なコンセプトです｡
また､ すべての言語で優れたプログラマーを目指すのであれば､ コメントも用意しています｡
でも､ コメントの仕方には､ 良い方法と悪い方法があります｡
そして､ これは練習すればできるようになるものです｡
しかし､ ここではいくつかの重要なガイドラインを紹介します｡
コードにコメントをつけるということは､ 価値のあるコメントをつけるということです｡
つまり､ ここに､ おい､ これは記号名変数､ アンドレ文字列の値だ､ というようなコメントを追加すると､
このようになります｡
あまり良くないですね｡
それはなぜでしょうか？
まあ､ あなたのコードは自分で説明できるはずだから､ ね｡
読みやすく､ 理解しやすいコードを書こうということです｡
気の利いたことを言おうとしているわけではありません｡
むしろ､ 英語のように読むべきでしょう｡
そして､ pythonのプログラマーなら誰でも､ ここでは単にnameの値としてAndreを追加しているだけだということがわかるでしょう｡
変数を代入して､ このように自己紹介のようなコメントをつけています｡
ただ､ コードがごちゃごちゃになるだけです｡
ここはトレードオフなんですね｡
例えば､ チームで仕事をしていて､ 他の開発者がやってきて､ あなたのコードを理解したいと思ったときに､ コードをコメントするのは良いことです｡
しかし､ コードは読みやすいというこの原則は忘れてはいけません｡
コードにコメントを付けたいのは､ この時だけです｡
本当に重要なことが起きていて､ それが少し複雑な場合､ まず､ このコードは理にかなった方法で書かれているかどうかを判断するんだ｡
例えば､ これが変数aだった場合｡
そして､ これが変数Bであった｡
まあ､ これは誰かにとっては本当に理解しがたいことかもしれませんね｡
だから､ これはフラグだと言えるかもしれません｡
しかし､ そのコメントを加える前に､ 「うーん､ 私のコードは読みにくいかもしれない」と自分に言い聞かせたいものです｡
変数をis coolに変えればもっと分かりやすくなるのかもしれませんね｡
そして､ コードを理解しやすくするためのツールとして､ コメントを活用したいものです｡
例えば､ あなたが書いたコードは､ 6ヶ月後に自分が何をしたのかを理解するために戻ってきたいと思うかもしれません｡
しかし､ コメントが多いからと言って､ 必ずしも良いコードになるとは限らないことを忘れないでください｡
読みにくいコードを読みやすくするのではなく､ 他の人がコードを理解するために必要な場合のみコメントを追加しながら､
簡潔で物事をシンプルに保ちたいものです｡
コースを通して､ このテーマを掘り下げ､ アドバイスをします｡
しかし､ この開発者の基本的なキーは､ キャリアを通じて必要になるものなので､ 覚えておいてください｡
ところで､ こちらの記事には､ 特にコメントのベストプラクティスにおいて､ 本当に重要なポイントが書かれており､
とても参考になると思います｡
コメントするときの注意点や､ トッププログラマーがどのようなことをしているのかが書かれています｡
バカバカしいと思うかもしれませんが､ ほとんどのコースが見落としている重要な概念なので､ ぜひ目を通しておくことをおすすめします｡
資料の中にリンクしておきますので､ 次のビデオでお会いしましょう｡