Налог на онбординг: скрытая стоимость устаревшего кодаКратко · дайджест за 9 июля
Кратко≈ 1 мин

Налог на онбординг: скрытая стоимость устаревшего кода

Проблема технического долга часто измеряется абстрактными показателями покрытия тестами. Однако реальная стоимость неупорядоченного кода выражается в часах рабочего времени, затрачиваемого новыми разработчиками на изучение системы. Это явление получило название «налога на онбординг» (onboarding tax).

Инженер поделился опытом погружения в стабильно работающий четыре года Go-сервис объемом 47 тысяч строк кода с хорошим покрытием тестами (71%). При отсутствии документации разработчик потратил около 31 часа чистого времени на исследование причин существования кода. Из них 11 часов ушло на изучение дублирующего функционала пакета sync2, 9 часов — на распутывание сосуществования Redis и локального кэша после незавершенной миграции, 7 часов — на мертвую прослойку трассировки запросов и 4 часа — на разрозненные пакеты утилит.

Зеленые тесты подтверждали работоспособность кода, но не объясняли, почему он написан именно так. Для снижения налога на онбординг командам рекомендуется внедрять записи архитектурных решений (ADR), подробно описывать контекст изменений в коммитах, своевременно удалять неиспользуемые абстракции и фиксировать логику незавершенных миграций.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 4