Make hover popover prettier

[ahoppen]

Essentially two changes:

1. Remove the symbol name from the hover. This name is already included in the documentation
2. Make the Alternative Result heading smaller.

Changes it from looking like this

to

rdar://126488098

[bnbarham]

Any thoughts on removing the horizontal rule after the declaration name and instead moving it prior to Alternative result? Needs something else too, since even with that I think I'd still start reading the bottom doc as the doc for the first result. Just... not sure what.

[ahoppen]

I did experiment with horizontal rulers to separate the results quite a bit and was never satisfied. FWIW, here’s how it looks like with a horizontal ruler before Alternative Result

And here without any rulers

[ahoppen]

And here’s a version that uses ###   to add some spacing between the results (best way I have found to add spacing in VS Code so far).

[ahoppen]

Next try. Heading Multiple Results if there are multiple results and horizontal rulers between the results.

[ahoppen]

@swift-ci Please test

[ahoppen]

@swift-ci Please test Windows

[bnbarham]

Nice, I think that's better. How about H3 still and with a horizontal line after the heading?

[ahoppen]

I prefer H2 and no line after the heading. Here’s how H3 and line after the heading looks like.

[ahoppen]

@swift-ci Please test

[bnbarham]

@swift-ci please test Windows platform

[bnbarham]

I still prefer H3 + line, but either is better than what's there now IMO. So happy to merge either way.