Я немного про другое. Есть комментарии "для себя"; есть объясняющие, что делает этот код, функция; а есть общая идея, как работает связка всего этого. Так, по моим наблюдениям - с последним обычно проблемы. И именно это является узким местом при понимании работы программ.