Documentation Link in Hover doesn't always display

[mjrussell]

Your environment

Which OS do you use:

MacOS M1

Steps to reproduce

I have 2 projects using the same VScode instance, latest plugin version (2.2.0), same HLS version (1.7.0) and stack (1.7.5) and GHC version (8.10.7).

In both of these projects, I can consistently get the Documentation Hover to show up which is great. What is less consistent is the hyperlink for the Documentation to open on Hackage.

It seems to work properly for things like base as you can see here

But no so for Conduit, esqueleto, monad-logger, or other dependencies.

Expected behaviour

Displays the Documentation link

Actual behaviour

Sometimes Displays the Documentation Link

Extra

My setup is a little difficult to run the debugging HLS command, because of some pathing interactions with GHCUP, but you can pretty easily reproduce also with this small repo + branch - https://github.com/mjrussell/haddocset/tree/bump-lts-18. I was trying to get dash docsets, but would rather see now about integrating this better into Vscode Haskell. Im interested in trying to contribute to vscode-haskell myself, but would appreciate some pointers if anyone has ideas on what might be wrong.

Mildly related, but is there also a way to programmatically do this command (Click on Documentation)? Would love a keyboard shortcut to open on hackage for text underneath the cursor. Similar to Go To Definition.

[mjrussell]

I did find the commands:
haskell.openDocumentationOnHackage and haskell.showDocumentation those both return some errors if i try to invoke them with my text on a cursor:
Cannot destructure property 'hackageUri' of 'undefined' as it is undefined.

[elldritch]

I can confirm this. For me, the documentation only shows up on exports from base packages.

When I build my dependencies with documentation: True, I do get a documentation link on non-base packages, but they seem malformed and always point to the html package, which is almost always wrong.

[pepeiborra]

For docs embedded in hover popups https://haskell-language-server.readthedocs.io/en/latest/configuration.html#how-to-show-local-documentation-on-hover

For hackage links there are other open issues already.

[elldritch]

Ah, yup, I see #520 now - I was searching the wrong keywords the first time around.