>>771
> 過去にトラブッた時の内容とか、それが解決した経緯とか、

そもそも、それはソースに書くようなことではなく、別のドキュメントに書くべき事ではないかな？
ソースファイルに書くコメントは関数の説明とか必要最低限のコメントにとどめておく