Код с комментариями — избыточность? Впервые устроился на работу. Компания имеет многолетний опыт и таких же опытных сотрудников. Много проектов на разных языках как новых, так и старых. Меня посадили за пару таких проектов, дали задания к нему и провели небольшой экскурс по каждому из них(для чего он нужен и что делает). Как только начал выполнять это самое задание, столкнулся с препятствием - кодом без комментариев. Нет, он понятен и лаконичен, но, скажем, чтобы понять зачем нужен тот или иной класс, нужно посмотреть его методы, свойства. наследование его классов (это python - тут множественное наследование имеет место быть) запомнить и проанализировать и спустя минут 5-10 только понять, для чего нужен этот класс. Хотя порою это совсем необязательно, порою нужно просто знать абстрактно об этом классе - для чего служит, зачем нужен и что делает. Все, больше ничего не надо. Дальше хлеще. Проект - фреймворк с кучей миксинов и классов, нужно уметь ими управлять и правильно употреблять. И вот представьте, что таких классов очень много и на осознание каждого из них уходит порядка 5-10 минут, плюсом идут скупые человеческие возможности, то есть запомнить все это нереально. Спустя уже 40 минут такого рысканья быстро утомляешься и работоспособность падает, соответсвенно производительно никакая.
Есть вариант - спрашивать у коллег, но, во-первых, вопросов много и отвлекать не хочется, а во-вторых, не хочется показаться уж совсем тупым(иногда мне так и кажется, порою на осознание какой то детали у меня уходит час, ища в иерархии классов ответ на вопрос, а тут приходит более опытный программист объясняет все это за 15 секунд...)
Так что же это? Недостаток опыта моего? Комментирование кода неактуально?

Предыдущий
вопрос Следующий
вопрос