Собственно немного флеймовая тема, но тем не менее. Есть два диаметральных подхода к комментариям
1) Комментируем все, что можно
2) Пишем код так, чтобы комментарии были не нужны . Ну или самый необходимый минимум
Есть ли у вас требования на работе к комментариям, и если есть то какие ?