foundation

Function size

Держите functions достаточно small, чтобы объяснять один intent, но избегайте extraction, который прячет flow или создает meaningless wrappers.

Функция — один уровень абстракции и один intent; часто 10–30 строк как эвристика, не закон. Extract, когда блоку нужно имя или reuse; не размазывайте линейный поток по meaningless one-line wrappers.

Если секции разделяете комментариями — возможно, нужны функции с именами секций.

На интервью: refactor 60 строк в orchestrator + helpers без потери читаемости.

Типовые ошибки: god function с IO и business rules; over-extraction; micro-functions портят stack traces.

Компромисс — локальная читаемость против jump-to-definition.

Чеклист:

Один intent на функцию.
Один уровень абстракции внутри.
Extract именованные шаги, не каждые две строки.