Works fine

… for param refs in Python docstrings imported via autodoc:

works.foo()

Things look fine for docstrings loaded via explicit autodoc directives:

Parameters:

bar – Some parameter.

  • ✅ Referenced via :paramref:`foo.bar`: foo.bar

  • ✅ Referenced via :paramref:`.bar`: bar

  • ✅ Referenced via :paramref:`bar`: bar

  • ❌ Referenced via default role as `foo.bar`: foo.bar

  • ❌ Referenced via default role as `.bar`: .bar

  • ✅ Referenced via default role as `bar`: bar