Links in function signatures not being resolved

[dstansby]

In the v3 docs, there are some internal references that aren't being linked in function signatures. For example, in the listing for zarr.Array, there should be a link for zarr.storage.StoreLike but there isn't. This is despite there being an entry for zarr.storage.StoreLike.

[dstansby]

StoreLike is showing up fine in the inventory, so I think the issue must be sphinx(-autoapi??) not inserting a cross link properly.

% python -m sphinx.ext.intersphinx _build/html/objects.inv | grep "StoreLike"
    zarr.storage.StoreLike                                                           : _autoapi/zarr/storage/index.html#zarr.storage.StoreLike
    zarr.storage.common.StoreLike                                                    : _autoapi/zarr/storage/common/index.html#zarr.storage.common.StoreLike

[dstansby]

In docs/_autoapi/zarr/storage/index.rst StoreLike is being documented as

.. py:data:: StoreLike

[dstansby]

I think we're running into sphinx-doc/sphinx#10785 here

[jhamman]

@dstansby - you are probably the expert here. Do we see a path to fixing this?

[dstansby]

Not without sphinx-doc/sphinx#10785 being fixed, which doesn't seem like it's going to happen soon. So definitely don't block v3 on this!