コメント
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 コメントはコードから明らかでない事項を説明すべきです