Каковы преимущества и недостатки использования docstrings вместо комментариев в Python?

Преимущества использования docstrings вместо комментариев в Python:

• Возможность программного доступа к docstrings. learntutorials.net Они сохраняются как атрибут функции, к ним можно получить доступ программно с помощью атрибута doc. learntutorials.net stackoverflow.com
• Возможность проверки комментариев во время выполнения. stackoverflow.com Это можно делать, например, в виде интерактивной справочной системы или в виде метаданных. stackoverflow.com
• Использование интерактивными справочными системами. stackoverflow.com Например, bpython и IPython могут отображать документацию во время разработки. stackoverflow.com

Недостатки использования docstrings:

• Необходимость размещать docstring сразу после определения названия модуля, функции, класса или метода. python-scripts.com
• Игнорирование docstrings во время выполнения кода. python-scripts.com Однако при добавлении к модулю, функции и так далее эта строка становится специальным атрибутом, доступным через doc. python-scripts.com