@property
def some_property(self):
    """This is the docstring of some_property"""
return None

def some_method(self):
    """This is the docstring of some_method.
        And this is a reference to :py:attr:`~some_property`
        """
Документация Sphinx: как ссылаться на свойство Python?