Комментарии штука действительно очень удобная. Но их нужно использовать грамотно и не злоупотреблять ими.
Твой код должен сам себя документировать. Да, в чистом коде должно быть понятно, что он делает без комментариев. Функции должны конкретно описывать, что они делают, а переменные — что они содержат.
Если непонятно, что делает код — не комментируй его, а перепиши. Если ты новичок и уже пишешь код, рекомендую почитать «Чистый код» Боба Мартина.
Зачем тогда комментарии? Они должны описывать специфическую бизнес-логику. То есть комментарий должен показывать, не что делает код, а зачем он это делает. Приведу пример на Python из своего старого проекта.
Не очень хороший комментарий:
Как это можно переписать:
Мы вынесли генерацию в функцию с говорящим названием, дали конкретное название переменной и заменили лишний технический комментарий на бизнесовый.
Комментируйте код, только когда это необходимо