Глава 4 · Python любит числа

Комментарии

Текст в коде, который читает только человек — компьютер его полностью пропускает.

Комментарий — это текст в коде, который Python полностью игнорирует при выполнении. Он нужен не компьютеру, а человеку: объяснить, зачем нужна эта строка, оставить напоминание себе или коллеге.

kommentarii.py
# Это комментарий — Python его не выполняет
age = 10  # а это комментарий в конце строки
print(age)

Комментарий начинается со знака # и продолжается до конца строки.

Хороший комментарий объясняет «почему», а не «что»
Строка age = 10 # присваиваем age значение 10 — бесполезный комментарий: и так понятно из кода. А age = 10 # минимальный возраст по умолчанию объясняет то, чего в самом коде не видно.

В этой книге мы придерживаемся именно такого стиля: комментарии на русском языке объясняют идею, а не пересказывают код построчно.