As in the JDT, if the user hovers over a type, the corresponding Javadoc should be shown. When scaladoc support is added, those doc comments should also be shown.

There are certainly JDT hooks to at least retrieve comments for Java identifiers.