Is there already an setting or issue somewhere to have the documentation popup only show up when you hover on the symbol rather than anywhere in the form? When forms are nested and split across multiple lines, it means there's a lot of space on the left side of the screen that looks like it should be safe to put your pointer in, but instead the doc popup shows up and obscures what you're working on. This makes it hard to find a spot on your screen to put the mouse pointer so the doc popup doesn't show up.
I ended up turning off the popup on hover and using and explicit command
That would be an issue on VS Code I think. I run with hovers disabled and trigger them with cmd+k cmd+i, btw.
I don't think that's a vscode issue, provideHover takes a position so Calva's making the decision about what to show.