Как говорил один умный программист "Код должен быть написан так, чтобы он сам был документацией к себе". Слова правильные, но истолковать их правильно не все сумеют. Читать мысли других программистов и гадать, что он там имел в веду нам не очень нравится. Чтобы избавить читателей Вашего кода от мук, мы научимся правильно составлять комментарии к своему коду на Python.

В Python все комментарии начинаются с символа # и все они они являются однострочными. В качестве многострочного комментария мы будем пользоваться строками документирования т.е. мы разместим код в утроенных кавычках.

Ниже я приведу несколько примеров комментариев на Python.

# Обычный текст комментария
my_var = 'Hi, Mowshon!' # Описываем переменную
# your_var = 'read' - в данном случае код не выполняется т.к. символ # в начале строки