タグ

ブックマーク / qiita.com/yoshinori_hisakawa (1)

  • 【まとめ】コードのコメントに対する自分の指針を決める - Qiita

    はじめに 今までコードの書き方の勉強には力を入れてきました。 ですが、コメントに対してはあまり意識せずにコーディングしてきました。 実際、コメントを書くのは面倒だし、書くことにメリットが見出せていませんでした。 理由は明確で、コメントを書くことのメリットや目的、自分の中での方針を決めるような時間を取っていなかったことが原因だと思います。 書く書かないなどいろんな流派があって答えはないと思いますが、 自分の中で理由とセットで意見を持つことは重要だと思うので、さっそくコメントにどう向きあうか考えてみます。 コメントを書くことのメリット・デメリット まずはコメントを書くことのメリット・デメリットについて洗い出してみます。 こんな重要なメリットやデメリットもあるよ!!などありましたらコメント欄でご指摘いただけますと幸いです。 メリット コードを読まなくてもメソッドの使い方などがわかる 初めてコード

    【まとめ】コードのコメントに対する自分の指針を決める - Qiita
  • 1