Docstrings и обычные комментарии в Python отличаются по назначению и формату. 2

Docstrings — это строковые литералы, которые предназначены для документирования кода. 2 Они располагаются внутри функций, классов или модулей и описывают их назначение. 1 В отличие от обычного комментария, docstring имеет более формальный статус и доступен в качестве атрибута doc у объектов. 2 Для создания docstring используют тройные кавычки ('''), в которые помещается текст. 2

Обычные комментарии в Python начинаются с символа # и используются для коротких пояснений, описывающих отдельные строки или небольшие блоки кода. 1

Таким образом, основное отличие в том, что docstrings используются для автодокументирования и предоставляют информацию о объектах Python (функциях, классах и методах), а обычные комментарии — для объяснения логики и назначения кода. 14