apidoc/python: Fix xrefs to type parameters

[jbms]

Previously, if a function introduced a type parameter, any references to that type parameter in the signature itself were correctly resolved. However, when documenting function parameters, the type from the signature is duplicated next to the parameter name, and any references to type parameters in these duplicated types were not correctly resolved.

This commit fixes that issue by applying the same resolution logic to the duplicated types.

[2bndy5]

Not sure how you discovered this. It might be worth adding :param: fields to the demo API docs in

sphinx-immaterial/docs/type_param_demo.py

Lines 63 to 73 in f5e3d7c

	@overload
	def get(self, key: K) -> Optional[V]: ...
	@overload
	def get(self, key: K, default: V) -> V: ...
	@overload
	def get(self, key: K, default: T) -> Union[V, T]: ...
	def get(self, key: K, default=None):
	"""Return the mapped value, or the specified default."""

[jbms]

Not sure how you discovered this. It might be worth adding :param: fields to the demo API docs in

Done.

Without this fix, the T in default :T as shown separately for the function parameter leads to an ambiguous reference warning if there is more than T anywhere, because it gets resolved as a top-down T reference.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 67.22%. Comparing base (7e2d559) to head (0d4de7e).
Report is 23 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #372      +/-   ##
==========================================
+ Coverage   63.00%   67.22%   +4.21%     
==========================================
  Files          68       68              
  Lines        8502     8512      +10     
==========================================
+ Hits         5357     5722     +365     
+ Misses       3145     2790     -355     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.