>>9
>それ以前に、コメントを書くのが面倒なんで、なんとかならんかと・・・

コメント入力支援機能のあるエディタかIDEを使うのが正解だと思う。
コメントのつけ方で悩んでいる場合は、とりあえずドキュメント生成ツールを開
発チームで導入して、コメントの書式を統一するところから始めてみては？
ドキュメント生成という目的があればコメントの入れ方の良し悪しも判断し易く
なるしね。