<p dir="ltr">I have am idea: how about including a @paramdoc decorator that accepts one named string argument per parameter and appends information gathered via type annotations and default values to the docstring?</p>
<p dir="ltr">E.g.</p>
<p dir="ltr">~~~~<br>
@paramdoc(<br>
    main_course="Meaty because our society is medieval",<br>
    side_dish="Optional, meat is enough",<br>
    __return__="Objective opinion")<br>
def eat(main_course: Meat, side_dish=None: Food) -> Opinion:<br>
    """<br>
    Decides how well the meat and side dish taste together<br>
    """<br>
    ...<br>
~~~~</p>
<p dir="ltr">After this, eat.__doc__ would be an object that retains the raw parts as properties, but otherwise is an elongated version of the original docstring. Its fourth and third to last line would read something like this:</p>
<p dir="ltr">~~~~<br>
side_dish (Food; defaults to None):<br>
    Optional, meat is enough<br>
~~~~</p>
<p dir="ltr">What do you think?</p>
<p dir="ltr">Guido van Rossum <<a href="mailto:guido@python.org">guido</a><a href="mailto:guido@python.org">@</a><a href="mailto:guido@python.org">python.org</a>> schrieb am Mo., 19. Jan. 2015 20:56:</p>