Ім'я змінної —
це найдешевша документація,
яку ти маєш.
І найчастіше
занедбана.
Ти пишеш d,
бо поспішаєш.
tmp,
бо «це ж тимчасово».
data,
бо ліньки думати.
А потім
через три місяці
сам не знаєш,
що там усередині.
Погане ім'я —
це борг.
Ти економиш
дві секунди сьогодні
й платиш
годину завтра.
Хороше ім'я
не потребує коментаря.
Воно саме
пояснює себе.
daysUntilExpiry
не бреше
й не старіє.
Тому не шкодуй часу
на ім'я.
Це єдина документація,
яку компілятор
змусить тебе
тримати поряд із кодом.
Назви чесно.
Назви точно.
І половина
твоїх коментарів
стане
непотрібною.
– Serguey Asael Shinder
