хороший код не требует комментариев
- общий механизм работы должен быть описан в проектном решении, а никак не в коде
- в комментарии к методу желательно давать информацию о возвращаемом значении и в редких случаях - о внутренних операциях

остальные комментарии нужны только когда твой код - говно