Right now hovering over a reference shows the signature, which is helpful.

However, it would be great if it also could read out the comment and show it (maybe render it as markdown?).

One needs to look into https://github.com/effekt-lang/effekt/blob/master/effekt/shared/src/main/scala/effekt/Intelligence.scala (getInfoOf), but also at how comments are parsed, and potentially attached to source nodes.

This is related to (but not necessarily dependent on) implementing a documentation generator.