наличие комментариев в коде - это показатель плохого кода ))
1. код должен хорошо читаться без комментариев, для этого должны использоваться понятные названия переменных, методов и классов
2. код должен быть покрыт тестами, не понятно, что делает кусок кода - зашел в тесты и понял