Что такое docstring и как его правильно писать?

Да, docstring — это строковый литерал сразу первой строкой в теле функции (класса, модуля), обычно в тройных кавычках. Он описывает, что делает функция.

def summa(a, b):
    """Возвращает сумму двух чисел."""
    return a + b

Чем отличается от комментария #:

• docstring сохраняется в самом объекте и доступен в рантайме через summa.__doc__ и help(summa);
• обычный комментарий # отбрасывается интерпретатором и нигде не доступен.

Поэтому docstring видят IDE, help() и инструменты документации. Для длинных функций принято описывать параметры и что возвращается (стили Google/NumPy/reStructuredText).