Low-boilerplate way of linking to API docs

[drothlis]

With rST I set default_role = "py:obj" in my conf.py, and then I can link to API docs like this:

The image you give to `stbt.match` or `stbt.wait_for_match` ...

Where "stbt" is the name of my Python module. The above automatically links to the documentation for those functions, which I have generated with autodoc.

With MyST, I have to do this:

The image you give to [stbt.match] or [stbt.wait_for_match] ...

[stbt.match]: stbt.match
[stbt.wait_for_match]: stbt.wait_for_match

Other syntaxes I tried:

markdown	does it work	notes
[stbt.match]	✗	Generates literal text (including brackets): [stbt.match]
[](stbt.match)	✗	Generates a hyperlink with the correct target but with no text, so it's invisible.
{ref}`stbt.match`	✗	Text appears, no hyperlink.
{py:obj}`stbt.match`	✓
{any}`stbt.match`	✓

[](stbt.match) does generate the correct link, but with no text:

<a class="reference internal" href="python-api.html#stbt.match" title="stbt.match">
  <span class="xref myst py py-func"></span>
</a>

For reference, this is what the rST input `stbt.match` generates:

<a class="reference internal" href="python-api.html#stbt.match" title="stbt.match">
  <code class="xref py py-obj docutils literal notranslate">
    <span class="pre">stbt.match</span>
  </code>
</a>

Note that this does work for other types of references. If I have this in one rST document:

.. _my-label:

My section title
----------------

...and then in another markdown document:

See [](my-label).

It does generate what you expect:

<p>
  See
  <a class="reference internal" href="configuration.html#my-label">
    <span class="std std-ref">My section title</span>
  </a>.
</p>

So... is the lack of text a bug in MyST or in autodoc? Perhaps if there's no text, MyST should use the text in the parentheses? (i.e. "stbt.match").

My ideal syntax would be [stbt.match], i.e. use the text in the brackets as the reference (if a reference isn't explicitly provided in parentheses like [text](reference) or later in the document like [text]: reference).