Type annotation guidelines

[Illviljan]

Dask has a pretty nice guideline for type hinting, see https://github.com/dask/community/issues/255.

Notable for us is to avoid adding typing in docstrings to avoid duplicating information.

[headtr1ck]

How exactly does it work with the automatic types in the docstring?

[benbovy]

How exactly does it work with the automatic types in the docstring?

Yes, what I really like in the html API documentation is the types (and especially the hyperlinks!) next to each name in the parameter list. Does napoleon support generating those links automatically from the typed signature?