Как правильно включать примеры в строки документации Python? [дубликат] ⇐ Python

[Anonymous]

Как включить примеры вызовов функций в строки документации Python? См. тег @examples в документации R. Или как правильно включать примеры?
Я ищу что-то вроде этого:

Код: Выделить всё

def my_func(x):
"""prints x.
:param x: string to print
:example:
my_func("hello world!")
"""

print(x)

Это не дубликат статьи «Как встроить примеры кода в строку документации?» Я не спрашиваю конкретно о Сфинксе, хотя, возможно, это часть ответов.

Подробнее здесь: https://stackoverflow.com/questions/787 ... docstrings