Технологии
по делу.

Абстракция — это как слой краски: первый слой скрывает неровности, второй уже начинает загромождать, а третий просто мешает видеть, что находится под ней. Недавно переписывал старый код, где каждый уровень абстракции обещал "универсальность" и "переиспользуемость". Получилось нечто вроде матрёшки: чтобы понять, что происходит, нужно пройти через пять слоёв индирекции. Баг ловишь, а сам не знаешь, в каком слое его искать — потому что каждый слой "правильно" делегирует проблему дальше. А потом начинаешь упрощать. Убираешь "универсальность" там, где она не нужна. Оставляешь абстракцию только там, где она реально экономит повторение кода, а не просто разбивает простую логику на двадцать файлов. И вот тогда всё вдруг становится понятнее — и работает быстрее, и баги ловятся в минуту вместо часа.

Сидел вчера над старым проектом, нашёл в нём README.md. Два года назад писал — помню, что старался. Скриншоты интерфейса, пошаговая инструкция, даже FAQ был. Сейчас это выглядит как археологический артефакт. Интерфейс изменился три раза, скриншоты показывают меню которого нет, а в FAQ на вопрос "почему ничего не работает" я сам же себе отвечал неправильно. И вот что забавно: код проекта за эти два года обновился, в нём разобраться проще, чем в моём же README. Потому что код — он либо работает, либо нет. А документация может тихо лежать и врать. Почему так происходит? Код трогаешь каждый день — неправильный кусок сразу бросается в глаза. А документация лежит в README, никто её не запускает, она просто есть. Пока кто-нибудь случайно не откроет и не поймёт, что читает историю. Вывод для себя простой: если документация — не первая сущность, а "потом допишу", она умрёт. Либо код должен генерировать документацию, либо документация должна быть частью CI, которая падает когда устаревает. Либо проще: не писать её вообще, чем писать и потом врать.

Открыл вчера модуль, который сам писал в прошлом ноябре. Читал минут пятнадцать и ловил себя на мысли: это что, правда моё? Причём не потому что плохо — в целом норм. Просто не узнавал логику, не помнил, почему выбрал такой способ, зачем тут эта прослойка. Особенно повеселили комментарии. Написал "здесь костыль, поправить позже" — ага, не поправил. Или "временное решение" — сюрприз, оно уже в проде полгода. Думаю, это нормально. Код пишешь ты, а понимаешь его другой ты — тот, кто уже забыл весь контекст. Поэтому стараюсь сейчас оставлять комментарии не про то "что делает код", а про то "почему именно так, а не иначе". Через год мой мозг скажет спасибо.