Существует ли стандарт или лучшая практика в Sphinx для предоставления более точных спецификаций для составных типов данных Python? Например, у меня есть функция, которая возвращает dict , отображающую str в str , и я использую стиль numpydoc ....

Я стараюсь использовать активные и описательные имена функций, которые затем документирую активным и описательным текстом (!). Это генерирует избыточный код. Упрощенный (но не такой уж нереалистичный) пример на питоне, следующий стилю numpy...