Преимущества многострочных строк документации:

• Возможность включить описание параметров функции и возвращаемых значений. 1 Оно отделяется от строки-команды пустой строкой. 1
• Легче обнаруживать ошибки. 2 Это связано с тем, что при создании многострочного строкового литерала нужно явно говорить об этом, заключив строку в тройные кавычки. 2
• Удобство встраивания данных и кода в скрипты. 2 Например, многострочные строки полезны для doctests. 2

Также при построчной записи удобнее комментировать конкретное свойство. 4 Например, можно автоматически обвить комментарий вокруг свойства в многострочной записи. 4

Выбор между однострочными и многострочными строками документации зависит от конкретных требований и предпочтений разработчика.