ソースコードへのコメントはプログラム構造に沿った形の記述しかできないので「過去にぜんぜん違う構造だったコードについての評価と解説のログ」みたいなのは残せない。そういう点でやっぱりソースコードそれ自体はあくまで(日々変化する環境の中に身を置くプロジェクトの) スナップショットでしかなくて、時間という構造に沿ったコメントとしてのコミットログは代替できない価値を持っているように思う
- replies
- 1
- announces
- 1
- likes
- 0
ソースと独立したドキュメント構造を用意しても、それはそれで同期が取れないとかソースの一部へリンクするのが面倒とかの問題があり……
もちろん (メンテナンスの不足により実情にそぐわぬ記述になる心配がないのであれば) コミットログとコメントにそれぞれ同じようなことを書くというのはありだと思う。そこは DRY とか気にしないで「あるべき場所に情報がある」ことを大事にしたい