docs(lsp): detail on hover window controls

runtime/doc/lsp.txt

@@ -1397,7 +1397,10 @@ format({opts})                                          *vim.lsp.buf.format()*
 
 hover()                                                  *vim.lsp.buf.hover()*
     Displays hover information about the symbol under the cursor in a floating
-    window. Calling the function twice will jump into the floating window.
+    window. The window will be dismissed on cursor move. Calling the function
+    twice will jump into the floating window. Once focused in the floating
+    window, the buffer content can be scrolled as usual and `q` can be used to
+    dismiss the window.
 
 implementation({opts})                          *vim.lsp.buf.implementation()*
     Lists all the implementations for the symbol under the cursor in the

runtime/lua/vim/lsp/buf.lua

@@ -29,7 +29,10 @@ local function request(method, params, handler)
 end
 
 --- Displays hover information about the symbol under the cursor in a floating
---- window. Calling the function twice will jump into the floating window.
+--- window. The window will be dismissed on cursor move.
+--- Calling the function twice will jump into the floating window.
+--- Once focused in the floating window, the buffer content can be scrolled as usual
+--- and `q` can be used to dismiss the window.
 function M.hover()
   local params = util.make_position_params()
   request(ms.textDocument_hover, params)