PR tox-dev#297 disabled overload detection to work around Sphinx not emitting
autodoc-process-signature events for overloaded functions. However, this
removed valuable type information from documentation, as users with complex
overloaded APIs lost their distinct signature variants.

Sphinx 9's directive-based architecture now handles overloads natively with
proper signature rendering. By removing the overload-clearing workaround,
all overload variants appear in documentation with their specific type
signatures intact, giving users complete type information for overloaded
functions.

Resolves tox-dev#529

PR tox-dev#297 disabled overload signatures to avoid Sphinx architectural issues where
autodoc-process-signature events don't fire for overloads. This removed valuable
type information from documentation for functions with multiple type signatures.

Instead of showing overloads in signature lines (where types can't be cross-referenced),
cache them during analysis and render them in docstrings as a formatted field list.
This gives each overload variant with properly cross-referenced types while avoiding
the architectural limitations.

Functions with @overload decorators now show:
  Overloads:
    * param (int) → str
    * param (list[int]) → dict[str, int]

All types are cross-referenced and clickable in HTML output. Generic return types
are suppressed when overloads are present since each variant already shows its
specific return type.

Resolves tox-dev#529

* ✨ feat(signatures): render overloads in docstrings with type formatting

PR #297 disabled overload signatures to avoid Sphinx architectural issues where
autodoc-process-signature events don't fire for overloads. This removed valuable
type information from documentation for functions with multiple type signatures.

Instead of showing overloads in signature lines (where types can't be cross-referenced),
cache them during analysis and render them in docstrings as a formatted field list.
This gives each overload variant with properly cross-referenced types while avoiding
the architectural limitations.

Functions with @overload decorators now show:
  Overloads:
    * param (int) → str
    * param (list[int]) → dict[str, int]

All types are cross-referenced and clickable in HTML output. Generic return types
are suppressed when overloads are present since each variant already shows its
specific return type.

Resolves #529

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>