Я стараюсь, чтобы мои строки документов были читаемыми, и мне тяжело с интерсфинксом и Наполеоном. У меня есть такой класс:
from long_import_path_one.long_import_path_two import Bar
from long_import_path_one.long_import_path_three import Baz
from long_import_path_one.long_import_path_four import Qux
from long_import_path_five.long_import_path_six import FooBar
class FooWithHorribleDocstrings(object):
"""
Data flows out through the :py:class:`long_import_path_one.long_import_path_two.Bar`
which owns a collection of :py:class:`long_import_path_one.long_import_path_three.Baz`
objects that read from a :py:class:`long_import_path_one.long_import_path_four.Qux`
and post to the backend using the :py:class:`long_import_path_five.long_import_path_six.FooBar`
"""
class FooWithCleanDocstrings(object):
"""
Data flows out through the ``Bar`` which owns a collection of ``Baz`` objects
that read from a ``Qux`` and post to the backend using the ``FooBar``
"""
Кажется глупым, что мне нужно полное имя, если я уже импортирую модули, но я не нашел способа заставить это работать. Есть предложения?