Show full function in ToC

[avivkeller]

@avivkeller

Thanks for connecting the dots about url.format !

What I see in the preview is two links with the same name "url.format"

pointing to

• url.format(urlObject)
• url.format(urlString)

and the production documentation lists

url.format(urlObject) in the TOC, including the extra (urlObject) text

whereas in the preview TOC it's only showing "url.format". So that confused me, although I do understand it now.

Originally posted by @MikeMcC399 in nodejs/node#52343 (comment)

[ovflowd]

On a similar note the MetaBar width could be increased even further on extra large screens (2xl or 3xl) to avoid the capping, if I recall my layout style changes would already make the ToC render on large and xlarge screens on the top. I am neutral moving the ToC to always be in the top, although I like the fact of having it on the side >>> and always accessible, not requiring scrolling. Another idea is to have the ToC fixed position (sticky) as on the screenshot below, but on the top, and that can be expanded at any time... But I worry these are bad ergonomics. Many other doc vendors, including Vercel also render the ToC on the side for that exact reason.

I know this is unrelated to the issue at hand, but just rectifying that I believe ToC on sidebar (Metabar) is the ideal solution.

[ovflowd]

Another unrelated note,

I feel somehow the spacing between sections on the Metabar is too big lol

[ovflowd]

I also noticed the MetaBar is not taking full height huh

[ovflowd]

Now on-topic, agreed we should have the full method signature, the screenshot below is confusing