Use auto documented typehints

The docstring typehints and the signature typehints are not consistent everywhere (naturally).

Also its annoying to always have this double book keeping.

There is the the sphinx_autodoc_typehints extension available, which automatically adds the type hints from signatures to the docstrings.

I would love to swap from the current template, to one that only has type hints in the signatures.

sphinx_autodoc_typehints has napoleon support and I tested it with our project -> works.

Only drawback being, that logical operator annotationstyles, like str | int are not supported (yet) and would have to be replaced by the more ugly Union[str, int]

If youd be ok with that, Id volunteer investing the hour for reformatting all the docstrings (basically just deleting the docstring typehints) Cant emphasize enough how that double book keeping is always deemed to be inconsistent given the number of funcions.