Better handling of function overloads in docs

[Rich-Harris]

Describe the problem

Describe the proposed solution

Does this need to be an overload? Is there a sneaky way we can adjust the type rather than adding doc generation logic?

Alternatives considered

No response

Importance

nice to have

Additional Information

No response