Комментарии – это пояснения к коду, которые добавляются, чтобы сделать код проще для понимания. Они никак не влияют на выполнение кода.
В Python комментарий добавляется путем вставки знака хэш-символа: #. Любой текст, идущий после него в той же строке игнорируется.

x = 365
y = 7
# this is a comment

print(x % y) # find the remainder
# print (x // y)
# another comment

Строки документации (англ. docstrings) служат той же цели, что и комментарии, то есть поясняют код. Но они используются для более конкретных объяснений и отличаются своим синтаксисом. Они представляют собой многострочное пояснение функции, которое следует после первой строки функции.

def shout(word):
“””
Print a word with an
exclamation mark following it.
“””
print(word + “!”)

shout(“spam”)

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