generated at
コメント
http://vega.pgw.jp/~kabe/vsd/comments-in-computer-languages.txt
/mrsekut-b/コメントは技術的負債になりやすい


コードで意図を表現できない場合にのみコメントを書く
画像を使ってコメントする
ToDo整理のためのコメント


コードの抽象表現としてのコメント

コメントを書く前に以下を考慮しよう
型を書く
関数を小さくする
テストを書く


コメントの分類
/mrsekut-book-APoSD/13.1 コメントの規約を決める

コメントを書く場所
/mrsekut-book-APoSD/16.2 コメントの維持：コメントをコードの近くに置く


https://jp.quora.com/コーディングの際-コメントってどのくらい書きます
数行の修正でも、その裏に大きな意図がある場合はコメントを書く
commit messageは追跡が大変な場合がある
なぜその実装方針を採用したのかを書く
他にもいくつか選択肢を試したけど、こういう理由でこれにしたという経緯を書く


/mrsekut-book-APoSD/Chapter13 コメントはコードから明らかでない事項を説明すべきです