コメントは多いほうがいいですね。例えば優秀なソースコードにはこんなコメントがたくさんあります。

//ここたぶん動かない
//間違ってるがなぜか動く
//ここ適当。後で考える
//なぜ？
//暫定
//ここはわからないので○○さんに確認（誰？）
//TODO:一から書き直したほうが早い
//この辺動かないのでコメントにしてみましたが、問題ないようです。未テスト
/* ここから下は使ってません */ //使ってます