overloaded functions have several signatures in the docs

[mathause]

See

(http://xarray.pydata.org/en/latest/generated/xarray.concat.html)

Can this be fixed? Or do we actually want to show both?

[keewis]

Good catch, @mathause.

I don't think we should show type hints at all (they're not visible in the API pages without @overload), that's what the parameter documentation is for. To solve this, I'd look for a configuration setting for autosummary / autodoc (I think the latter generates the signature) or try to figure out if that's a bug / missing feature in autodoc.

[mathause]

maybe: https://www.sphinx-doc.org/en/2.0/usage/extensions/autodoc.html#confval-autodoc_typehints can check tomorrow

[keewis]

that's already set:

xarray/doc/conf.py

Line 112 in 45aab42

autodoc_typehints = "none"

so I guess this is a missing feature for autodoc. sphinx-doc/sphinx#7785, maybe?

[mathause]

Yes, does sound like the issue. I guess we'll have to wait for upstream...

[keewis]

this is fixed in sphinx=3.3.0, so updating the pinned version in doc.yml should be enough