>>590,594
俺的にはコードに適度な粒度でコメントは書け。
ソース上ではどうしても複数の要素間の前提、作用などは書きづらいので仕組み的なものについては別に書け。
ある程度聞かれる可能性のあることは書け。

って感じかね。どこまでってのはあるがざっくりある程度としか言えん。
自分は自分のためにソース上ではざっとみて内容がわかるレベルのコメント、クラス図と相互作用図を合わせたようなポンチ絵、その裏にある思想を書いてる。