Следование стандартам написания документации в Python важно, потому что это:

• Делает код более читаемым. 23 Документация помогает понять, что делает функция или класс, какие аргументы она принимает и что в итоге возвращает. 3
• Облегчает понимание кода другими разработчиками. 3 Это может помочь им более эффективно внести предложения по улучшению кода. 3
• Поддерживает единый стиль документации. 1 Это особенно важно в крупных проектах. 1
• Позволяет использовать инструменты для генерации структурированной документации. 1 Например, Sphinx позволяет сгенерировать из ясных и хорошо оформленных докстрок структурированную и эстетически приятную документацию. 1

Стандарты написания документации в Python, в частности, описаны в PEP 257, который устанавливает рекомендации по оформлению докстроков (строк документации). 14