From 17008c63eccbb56aeb3a27f7d26bce3d66e03fa7 Mon Sep 17 00:00:00 2001 From: Michael Lingelbach Date: Fri, 19 Nov 2021 20:11:15 -0500 Subject: docs: clarify server naming conventions (#1456) --- CONTRIBUTING.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'CONTRIBUTING.md') diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2ac4f6c8..be2301ad 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -13,6 +13,8 @@ The point of lspconfig is to provide the minimal configuration necessary for a s The general form of adding a new language server is to start with a minimal skeleton. This includes populated the `config` table with a `default_config` and `docs` table. +When choosing a server name, convert all 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`). + `default_config` should include, at minimum the following: * `cmd`: a list which includes the executable name as the first entry, with arguments constituting subsequent list elements (`--stdio` is common) * `filetypes`: a list for filetypes a -- cgit v1.2.3-70-g09d2