vscode-html-languageserver: document reason completion is not on by default

1 files changed, 14 insertions, 1 deletions

diff --git a/lua/lspconfig/html.lua b/lua/lspconfig/html.lua
index 23cdcb88..0cb5c80d 100644
--- a/lua/lspconfig/html.lua
+++ b/lua/lspconfig/html.lua
@@ -24,10 +24,23 @@ configs[server_name] = {
     description = [[
 https://github.com/vscode-langservers/vscode-html-languageserver-bin
 
-`html-languageserver` can be installed via `npm`:
+`vscode-html-languageserver` can be installed via `npm`:
 ```sh
 npm install -g vscode-html-languageserver-bin
 ```
+
+Neovim does not currently include built-in snippets. `vscode-html-languageserver` only provides completions when snippet support is enabled.
+To enable completion, install a snippet plugin and add the following override to your language client capabilities during setup.
+
+```lua
+--Enable (broadcasting) snippet capability for completion
+local capabilities = vim.lsp.protocol.make_client_capabilities()
+capabilities.textDocument.completion.completionItem.snippetSupport = true
+
+require'lspconfig'.html.setup {
+  capabilities = capabilities,
+}
+```
 ]];
   };
 }