aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--CONTRIBUTING.md8
-rw-r--r--doc/lspconfig.txt6
2 files changed, 11 insertions, 3 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2b79c9d2..979ff78b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -17,6 +17,14 @@ The point of lspconfig is to provide the minimal configuration necessary for a s
## Adding a server to lspconfig
+New configs must meet these criteria (to avoid spam/quasi-marketing/vanity projects):
+
+- GitHub Stars: The server repository should have at least 100 stars, or some other evidence (such as vscode marketplace downloads) that the LSP server is reasonably popular and is not spam/quasi-marketing/vanity projects.
+- Provide some reference or evidence that the language targeted by the LSP server has an active user base.
+
+This helps ensure that we only include actively maintained and widely used servers to provide a better experience for
+the community.
+
To add a new language server, start with a minimal skeleton. See `:help lspconfig-new`.
When choosing a config name, convert dashes (`-`) to underscores (`_`). If the name of the server is a unique name (`pyright`, `clangd`) or a commonly used abbreviation (`zls`), prefer this as the server name. If the server instead follows the pattern x-language-server, prefer the convention `x_ls` (`jsonnet_ls`).
diff --git a/doc/lspconfig.txt b/doc/lspconfig.txt
index 0ba19021..553d7362 100644
--- a/doc/lspconfig.txt
+++ b/doc/lspconfig.txt
@@ -382,9 +382,9 @@ Launches the requested (configured) client, but only if it successfully
resolves a root directory. Note: Defaults to all configured servers matching
the current buffer filetype.
-:LspStop [client_id] *:LspStop*
-Stops the server with the given client id. Defaults to stopping all servers
-active on the current buffer. To force stop a language server: >
+:LspStop [client_id] or [config_name] *:LspStop*
+Stops the server with the given client-id or config name. Defaults to stopping
+all servers active on the current buffer. To force stop a language server: >
:LspStop <client_id> ++force
:LspRestart [client_id] *:LspRestart*