Ім'я змінної: це найдешевша документація

Ім'я змінної —
це найдешевша документація,
яку ти маєш.

І найчастіше
занедбана.

Ти пишеш d,
бо поспішаєш.
tmp,
бо «це ж тимчасово».
data,
бо ліньки думати.

А потім
через три місяці
сам не знаєш,
що там усередині.

Погане ім'я —
це борг.
Ти економиш
дві секунди сьогодні
й платиш
годину завтра.

Хороше ім'я
не потребує коментаря.
Воно саме
пояснює себе.

daysUntilExpiry
не бреше
й не старіє.

Тому не шкодуй часу
на ім'я.

Це єдина документація,
яку компілятор
змусить тебе
тримати поряд із кодом.

Назви чесно.
Назви точно.

І половина
твоїх коментарів
стане
непотрібною.

– Serguey Asael Shinder