DOC: do we want type hints in signature on API pages?

[jorisvandenbossche]

With the type hints that are being added in a lot of places, the question comes up if we want to have them in the docs.

Currently, this actually happens. See eg https://dev.pandas.io/docs/reference/api/pandas.DataFrame.to_string.html#pandas.DataFrame.to_string

But personally, I am not sure the having the type hints in the signature like above is an improvement. It makes the signature very hard to read and interpret, while we (in principle) already have the type information in textual form in the Parameter listing.

[WillAyd]

I think these are good to have; serving as a form of documentation is one of the motivators for annotations

[TomAugspurger]

Closing in favor of #33025, which has a couple links to workarounds.