Очень часто нужно добавлять описание к коду Python. Если не комментировать свой код, то трудно разобраться в том что вы делали. Вы можете делать комментарий в самом начале документа py. Обычно так и поступают. Для функций комментарий нужно помещать во внутрь тела функции. Я обычно использую одинарные кавычки по 3 штуки в блоке '''ваш комментарий'''.
#!/usr/bin/python3
def display(str):
'''выводим значения аргумента'''
print(str)
# просто выводим строку
display('string')
'''
вывод:
string
'''
# вывод комментария функции
display(display.__doc__)
'''
вывод:
выводим значения аргумента
'''
Вы можете использовать решётку #. Если ваш комментарий короткий, то можете смело использовать этот символ.
#!/usr/bin/python3
# данные пользователя
lang='Python'
name='Ivan'