From 8cdfcaa5337704f45b1584f8ae24f4c2543d5712 Mon Sep 17 00:00:00 2001
From: PerilousBooklet <raffaele.orabona@protonmail.com>
Date: Tue, 3 Dec 2024 10:15:28 +0100
Subject: [PATCH 1/7] Sorting LSP server entries by alphabetical order.

---
 config.lua | 438 +++++++++++++++++++++++++++--------------------------
 1 file changed, 220 insertions(+), 218 deletions(-)

diff --git a/config.lua b/config.lua
index cc47662..ede9793 100644
--- a/config.lua
+++ b/config.lua
@@ -81,7 +81,9 @@ end
 ---@class lsp.config
 local lspconfig = {}
 
----# bash-language-server
+-- NOTE: the sorting will occur in the following order: prog_lang_name, LSP_server_name
+
+---# Bash - bash-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/bash-lsp/bash-language-server
 --- __Installation__: `npm i -g bash-language-server`
@@ -95,7 +97,7 @@ lspconfig.bashls = add_lsp {
   verbose = false
 }
 
----# ccls
+---# C/C++ - ccls
 --- __Status__: Works
 --- __Site__: https://github.com/MaskRay/ccls/
 --- __Installation__: https://github.com/MaskRay/ccls/wiki
@@ -116,7 +118,7 @@ lspconfig.ccls = add_lsp {
   verbose = false
 }
 
----# clangd
+---# C/C++ - clangd
 --- __Status__: Works
 --- __Site__: https://clangd.llvm.org/
 --- __Installation__: install the clang software package on your system
@@ -138,7 +140,7 @@ lspconfig.clangd = add_lsp {
   verbose = false
 }
 
----# Clojure
+---# Clojure - clojure-lsp
 --- __Status__: Untested
 --- __Site__: https://clojure-lsp.github.io/
 --- __Installation__: https://clojure-lsp.github.io/clojure-lsp/installation/
@@ -150,7 +152,7 @@ lspconfig.clojure_lsp = add_lsp {
   verbose = false
 }
 
----# Crystal
+---# Crystal - crystalline
 --- __Status__: Works
 --- __Site__: https://github.com/elbywan/crystalline
 --- __Installation__: 'paru -S crystalline-bin'
@@ -162,7 +164,7 @@ lspconfig.crystalline = add_lsp {
   verbose = false
 }
 
----# vscode-css-languageserver
+---# CSS - vscode-css-languageserver
 --- __Status__: Works
 --- __Site__: https://github.com/vscode-langservers/vscode-css-languageserver-bin
 --- __Installation__: `npm install -g vscode-css-languageserver-bin`
@@ -183,7 +185,19 @@ lspconfig.cssls = add_lsp {
   verbose = false
 }
 
----# D
+---# C# - omnisharp
+--- __Status__: Works but, freeze on large projects (https://github.com/ppy/osu.git)
+--- __Site__: https://github.com/OmniSharp/omnisharp-roslyn
+--- __Installation__: See official website for instructions
+lspconfig.omnisharp = add_lsp {
+  name = "omnisharp",
+  language = "csharp",
+  file_patterns = { "%.cs$" },
+  command = { "omnisharp", "-lsp" },
+  verbose = false
+}
+
+---# D - serve-d
 --- __Status__: Works
 --- __Site__: https://github.com/Pure-D/serve-d
 --- __Installation__: https://github.com/Pure-D/serve-d?tab=readme-ov-file#installation
@@ -195,7 +209,7 @@ lspconfig.serve_d = add_lsp {
   verbose = false
 }
 
----# dartls
+---# Dart - dartls
 --- __Status__: Untested
 --- __Site__: https://github.com/dart-lang/sdk
 --- __Installation__: Provided in dart sdk
@@ -253,7 +267,7 @@ lspconfig.deno = add_lsp {
   }
 }
 
----# Dockerfile
+---# Dockerfile - dockerfile-language-server-nodejs
 --- __Status__: Untested
 --- __Site__: https://github.com/rcjsuen/dockerfile-language-server-nodejs
 --- __Installation__: `npm install -g dockerfile-language-server-nodejs`
@@ -265,7 +279,7 @@ lspconfig.dockerls = add_lsp {
   verbose = false
 }
 
----# Elixir
+---# Elixir - elixir-ls
 --- __Status__: Works
 --- __Site__: https://github.com/elixir-lsp/elixir-ls
 --- __Installation__: 'paru -S elixir-ls'
@@ -277,7 +291,7 @@ lspconfig.elixirls = add_lsp {
   verbose = false
 }
 
----# Elm
+---# Elm - elm-language-server
 --- __Status__: Untested
 --- __Site__: https://github.com/elm-tooling/elm-language-server
 --- __Installation__: `paru -S elm-language-server`
@@ -289,7 +303,7 @@ lspconfig.elmls = add_lsp {
   verbose = false
 }
 
----# Erlang
+---# Erlang - erlang_ls
 --- __Status__: Untested
 --- __Site__: https://github.com/erlang-ls/erlang_ls
 --- __Installation__: ?
@@ -301,7 +315,7 @@ lspconfig.erlangls = add_lsp {
   verbose = false
 }
 
----# fennel-ls
+---# Fennel - fennel-ls
 --- __Status__: Untested
 --- __Site__: https://git.sr.ht/~xerool/fennel-ls
 --- __Installation__:
@@ -318,18 +332,6 @@ lspconfig.fennells = add_lsp {
   verbose = false
 }
 
----# Flow - JavaScript
---- __Status__: Untested
---- __Site__: https://flow.org/
---- __Installation__: `npm install -g flow-bin`
-lspconfig.flow = add_lsp {
-  name = "flow",
-  language = "javascript",
-  file_patterns = { "%.js$", "%.jsx$" },
-  command = { "flow", "lsp" },
-  verbose = false
-}
-
 ---# Fortran - fortls
 --- __Status__: Works
 --- __Site__: https://fortls.fortran-lang.org/index.html
@@ -354,7 +356,7 @@ lspconfig.gleam = add_lsp {
 	verbose = false
 }
 
----# gopls
+---# Go - gopls
 --- __Status__: Works
 --- __Site__: https://pkg.go.dev/golang.org/x/tools/gopls
 --- __Installation__: `go get -u golang.org/x/tools/gopls`
@@ -366,7 +368,7 @@ lspconfig.gopls = add_lsp {
   verbose = false
 }
 
----# groovy-language-server
+---# Groovy - groovy-language-server
 --- __Status__: Untested
 --- __Site__: https://github.com/prominic/groovy-language-server
 --- __Installation__:
@@ -386,7 +388,7 @@ lspconfig.groovyls = add_lsp {
   verbose = false
 }
 
----# haskell-language-server
+---# Haskell - haskell-language-server
 --- __Status__: Untested
 --- __Site__: https://github.com/haskell/haskell-language-server
 --- __Installation__: `ghcup install hls`
@@ -399,7 +401,7 @@ lspconfig.hls = add_lsp {
   verbose = false
 }
 
----# vscode-html-languageserver
+---# HTML - vscode-html-languageserver
 --- __Status__: Works
 --- __Site__: https://github.com/vscode-langservers/vscode-html-languageserver-bin
 --- __Installation__: `npm install --global vscode-html-languageserver-bin`
@@ -419,23 +421,7 @@ lspconfig.html = add_lsp {
   verbose = false
 }
 
----# intelephense
---- __Status__: Works
---- __Site__: https://github.com/bmewburn/intelephense-docs
---- __Installation__: `npm -g install intelephense`
---- __Note__: Set your license and storage by passing the init_options as follows:
---- ```lua
---- init_options = { licenceKey = "...", storagePath = "/some/path"}
---- ```
-lspconfig.intelephense = add_lsp {
-  name = "intelephense",
-  language = "php",
-  file_patterns = { "%.php$" },
-  command = { "intelephense", "--stdio" },
-  verbose = false
-}
-
----# java
+---# Java - jdtls
 --- __Status__: Works
 --- __Site__: https://github.com/eclipse/eclipse.jdt.ls
 lspconfig.jdtls = add_lsp {
@@ -446,19 +432,38 @@ lspconfig.jdtls = add_lsp {
   verbose = false
 }
 
----# Scala
+---# Javascript - flow
+--- __Status__: Untested
+--- __Site__: https://flow.org/
+--- __Installation__: `npm install -g flow-bin`
+lspconfig.flow = add_lsp {
+  name = "flow",
+  language = "javascript",
+  file_patterns = { "%.js$", "%.jsx$" },
+  command = { "flow", "lsp" },
+  verbose = false
+}
+
+---# Javascript - quick-lint-js
 --- __Status__: Works
---- __Site__: https://scalameta.org/metals/
---- __Installation__: `paru -S metals`
-lspconfig.metals = add_lsp {
-  name = "metals",
-  language = "scala",
-  file_patterns = { "%.scala$" },
-  command = { "metals" },
+--- __Site__: https://github.com/quick-lint/quick-lint-js
+--- __Installation__: Arch Linux: `yay -Syu quick-lint-js`
+lspconfig.quicklintjs = add_lsp {
+  name = "quick-lint-js",
+  language = {
+    { id = "javascriptreact",      pattern = "%.jsx$"   },
+    { id = "javascript",           pattern = "%.js$"    },
+    { id = "typescriptdefinition", pattern = "%.d%.ts$" },
+    { id = "typescriptsource",     pattern = "%.ts$"    },
+    { id = "typescriptreact",      pattern = "%.tsx$"   },
+    { id = "typescript",           pattern = ".*"       },
+  },
+  file_patterns = { "%.[mc]?jsx?$", "%.tsx?$" },
+  command = { "quick-lint-js", "--lsp-server" },
   verbose = false
 }
 
----# vscode-json-languageserver
+---# JSON - vscode-json-languageserver
 --- __Status__: Works
 --- __Site__: https://www.npmjs.com/package/vscode-json-languageserver
 --- __Installation__: `npm install -g vscode-json-languageserver`
@@ -478,7 +483,7 @@ lspconfig.jsonls = add_lsp {
   verbose = false
 }
 
----# kotlin-language-server
+---# Kotlin - kotlin-language-server
 --- __Status__: Untested
 --- __Site__: https://github.com/fwcd/kotlin-language-server
 --- __Installation__: https://github.com/fwcd/kotlin-language-server/releases
@@ -490,19 +495,78 @@ lspconfig.kotlin_language_server = add_lsp {
   verbose = false
 }
 
----# XML
+---# LaTeX - texlab
 --- __Status__: Works
---- __Site__: https://github.com/eclipse/lemminx
---- __Installation__: 'paru -S lemminx'
-lspconfig.lemminx = add_lsp {
-  name = "lemminx",
-  language = "xml",
-  file_patterns = { "%.xml$" },
-  command = { "lemminx" },
-  verbose = false
+--- __Site__: https://github.com/latex-lsp/texlab
+--- __Installation__: git clone https://github.com/latex-lsp/texlab.git , then inside the texlab folder, run: cargo build --release
+--- __Note__: Rust has to be installed
+lspconfig.texlab = add_lsp {
+  name = "texlab",
+  language = "latex",
+  file_patterns = { "%.tex$", "%.bib$" , "%.dtx$", "%.sty$", "%.ins$", "%.cls$" },
+  command = { 'texlab' }
 }
 
----# nil
+---# Lua - lua-language-server
+--- __Status__: Works
+--- __Site__: https://github.com/sumneko/lua-language-server
+--- __Installation__: https://github.com/sumneko/lua-language-server/wiki/Build-and-Run-(Standalone)
+lspconfig.sumneko_lua = add_lsp {
+  name = "lua-language-server",
+  language = "lua",
+  file_patterns = { "%.lua$" },
+  command = { 'lua-language-server' },
+  verbose = false,
+  settings = {
+    Lua = {
+      completion = {
+        enable = true,
+        callSnippet = snippets and "Replace" or "Disable",
+        keywordSnippet = snippets and "Replace" or "Disable"
+      },
+      develop = {
+        enable = false,
+        debuggerPort = 11412,
+        debuggerWait = false
+      },
+      diagnostics = {
+        enable = true,
+      },
+      hover = {
+        enable = true,
+        viewNumber = true,
+        viewString = true,
+        viewStringMax = 1000
+      },
+      runtime = {
+        version = 'Lua 5.4',
+        path = {
+          "?.lua",
+          "?/init.lua",
+          "?/?.lua",
+          "/usr/share/5.4/?.lua",
+          "/usr/share/lua/5.4/?/init.lua"
+        }
+      },
+      signatureHelp = {
+        enable = true
+      },
+      workspace = {
+        library = {
+          DATADIR,
+          USERDIR
+        },
+        maxPreload = 2000,
+        preloadFileSize = 1000
+      },
+      telemetry = {
+        enable = false
+      }
+    }
+  }
+}
+
+---# Nix - nil
 --- __Status__:       Works
 --- __Site__:         https://github.com/oxalica/nil
 --- __Installation__: cargo install --git https://github.com/oxalica/nil nil
@@ -515,7 +579,7 @@ lspconfig.nillsp = add_lsp {
   verbose = false
 }
 
----# nimlsp
+---# Nim - nimlsp
 --- __Status__: Works
 --- __Site__: https://github.com/PMunch/nimlsp
 --- __Installation__: `nimble install nimlsp`
@@ -529,7 +593,7 @@ lspconfig.nimlsp = add_lsp {
   verbose = false
 }
 
----# ocaml-lsp
+---# Ocaml - ocaml-lsp
 --- __Status__: Reported working on https://github.com/jgmdev/lite-xl-lsp/issues/17
 --- __Site__: https://github.com/ocaml/ocaml-lsp
 --- __Installation__: https://github.com/ocaml/ocaml-lsp#installation
@@ -541,7 +605,7 @@ lspconfig.ocaml_lsp = add_lsp {
   verbose = false
 }
 
----# Odin
+---# Odin - ols
 --- __Status__: Works
 --- __Site__: https://github.com/DanielGavin/ols
 --- __Installation__: `paru -S odinls`
@@ -553,19 +617,7 @@ lspconfig.odinls = add_lsp {
   verbose = false
 }
 
----# omnisharp
---- __Status__: Works but, freeze on large projects (https://github.com/ppy/osu.git)
---- __Site__: https://github.com/OmniSharp/omnisharp-roslyn
---- __Installation__: See official website for instructions
-lspconfig.omnisharp = add_lsp {
-  name = "omnisharp",
-  language = "csharp",
-  file_patterns = { "%.cs$" },
-  command = { "omnisharp", "-lsp" },
-  verbose = false
-}
-
----# PerlNavigator - Perl
+---# Perl - PerlNavigator
 --- __Status__: Works
 --- __Site__: https://github.com/bscan/PerlNavigator
 --- __Installation__: `paru -S perlnavigator`
@@ -582,7 +634,23 @@ lspconfig.perlnavigator = add_lsp {
   }
 }
 
----# python-language-server
+---# PHP - intelephense
+--- __Status__: Works
+--- __Site__: https://github.com/bmewburn/intelephense-docs
+--- __Installation__: `npm -g install intelephense`
+--- __Note__: Set your license and storage by passing the init_options as follows:
+--- ```lua
+--- init_options = { licenceKey = "...", storagePath = "/some/path"}
+--- ```
+lspconfig.intelephense = add_lsp {
+  name = "intelephense",
+  language = "php",
+  file_patterns = { "%.php$" },
+  command = { "intelephense", "--stdio" },
+  verbose = false
+}
+
+---# Python - python-language-server
 --- __Status__: Works (deprecated in favor of python-lsp-server)
 --- __Site__: https://github.com/palantir/python-language-server
 --- __Installation__: `pip install python-language-server`
@@ -596,7 +664,7 @@ lspconfig.pyls = add_lsp {
   verbose = false
 }
 
----# python-lsp-server
+---# Python - python-lsp-server
 --- __Status__: Works
 --- __Site__: https://github.com/python-lsp/python-lsp-server
 --- __Installation__: `pip install python-lsp-server`
@@ -610,7 +678,7 @@ lspconfig.pylsp = add_lsp {
   verbose = false
 }
 
---# pyright
+--# Python - pyright
 --- __Status__: Works
 --- __Site__: https://github.com/microsoft/pyright
 --- __Installation__: `pip install pyright`  or `npm install -g pyright`
@@ -622,25 +690,6 @@ lspconfig.pyright = add_lsp {
   verbose = false
 }
 
----# quick-lint-js
---- __Status__: Works
---- __Site__: https://github.com/quick-lint/quick-lint-js
---- __Installation__: Arch Linux: `yay -Syu quick-lint-js`
-lspconfig.quicklintjs = add_lsp {
-  name = "quick-lint-js",
-  language = {
-    { id = "javascriptreact",      pattern = "%.jsx$"   },
-    { id = "javascript",           pattern = "%.js$"    },
-    { id = "typescriptdefinition", pattern = "%.d%.ts$" },
-    { id = "typescriptsource",     pattern = "%.ts$"    },
-    { id = "typescriptreact",      pattern = "%.tsx$"   },
-    { id = "typescript",           pattern = ".*"       },
-  },
-  file_patterns = { "%.[mc]?jsx?$", "%.tsx?$" },
-  command = { "quick-lint-js", "--lsp-server" },
-  verbose = false
-}
-
 ---# R
 -- __Status__: Works
 -- __Site__:https://github.com/REditorSupport/languageserver#installation
@@ -653,19 +702,7 @@ lspconfig.rlanguageserver = add_lsp {
   verbose = false
 }
 
----# Rust Language Server
---- __Status__: Works
---- __Site__: https://github.com/rust-lang/rls
---- __Installation__: Install rust on your system
-lspconfig.rls = add_lsp {
-  name = "rust-language-server",
-  language = "rust",
-  file_patterns = { "%.rs$" },
-  command = { 'rls' },
-  verbose = false
-}
-
----# Ruby LSP
+---# Ruby - ruby-lsp
 --- __Status__: Untested
 --- __Site__: https://github.com/Shopify/ruby-lsp
 --- __Instalation__: gem install ruby-lsp
@@ -702,7 +739,19 @@ lspconfig.ruby_lsp = add_lsp {
   verbose = false
 }
 
----# Rust Analyzer
+---# Rust - rls
+--- __Status__: Works
+--- __Site__: https://github.com/rust-lang/rls
+--- __Installation__: Install rust on your system
+lspconfig.rls = add_lsp {
+  name = "rust-language-server",
+  language = "rust",
+  file_patterns = { "%.rs$" },
+  command = { 'rls' },
+  verbose = false
+}
+
+---# Rust - rust-analyzer
 --- __Status__: Works
 --- __Site__: https://rust-analyzer.github.io/
 --- __Installation__: See official website for instructions
@@ -714,6 +763,18 @@ lspconfig.rust_analyzer = add_lsp {
   verbose = false
 }
 
+---# Scala - metals
+--- __Status__: Works
+--- __Site__: https://scalameta.org/metals/
+--- __Installation__: `paru -S metals`
+lspconfig.metals = add_lsp {
+  name = "metals",
+  language = "scala",
+  file_patterns = { "%.scala$" },
+  command = { "metals" },
+  verbose = false
+}
+
 ---# Solargraph
 --- __Status__: Untested
 --- __Site__: https://github.com/castwide/solargraph
@@ -726,7 +787,7 @@ lspconfig.solargraph = add_lsp {
   verbose = false
 }
 
----# sql-language-server
+---# SQL - sql-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/joe-re/sql-language-server
 --- __Installation__: `npm i -g sql-language-server`
@@ -738,66 +799,7 @@ lspconfig.sqlls = add_lsp {
   verbose = false
 }
 
----# lua-language-server
---- __Status__: Works
---- __Site__: https://github.com/sumneko/lua-language-server
---- __Installation__: https://github.com/sumneko/lua-language-server/wiki/Build-and-Run-(Standalone)
-lspconfig.sumneko_lua = add_lsp {
-  name = "lua-language-server",
-  language = "lua",
-  file_patterns = { "%.lua$" },
-  command = { 'lua-language-server' },
-  verbose = false,
-  settings = {
-    Lua = {
-      completion = {
-        enable = true,
-        callSnippet = snippets and "Replace" or "Disable",
-        keywordSnippet = snippets and "Replace" or "Disable"
-      },
-      develop = {
-        enable = false,
-        debuggerPort = 11412,
-        debuggerWait = false
-      },
-      diagnostics = {
-        enable = true,
-      },
-      hover = {
-        enable = true,
-        viewNumber = true,
-        viewString = true,
-        viewStringMax = 1000
-      },
-      runtime = {
-        version = 'Lua 5.4',
-        path = {
-          "?.lua",
-          "?/init.lua",
-          "?/?.lua",
-          "/usr/share/5.4/?.lua",
-          "/usr/share/lua/5.4/?/init.lua"
-        }
-      },
-      signatureHelp = {
-        enable = true
-      },
-      workspace = {
-        library = {
-          DATADIR,
-          USERDIR
-        },
-        maxPreload = 2000,
-        preloadFileSize = 1000
-      },
-      telemetry = {
-        enable = false
-      }
-    }
-  }
-}
-
----# svelte-language-server
+---# Svelte - svelte-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/sveltejs/language-tools/tree/master/packages/language-server
 --- __Installation__: `npm install -g svelte-language-server`
@@ -824,19 +826,7 @@ lspconfig.tailwindcss = add_lsp {
   verbose = false
 }
 
----# LaTeX Texlab language server
---- __Status__: Works
---- __Site__: https://github.com/latex-lsp/texlab
---- __Installation__: git clone https://github.com/latex-lsp/texlab.git , then inside the texlab folder, run: cargo build --release
---- __Note__: Rust has to be installed
-lspconfig.texlab = add_lsp {
-  name = "texlab",
-  language = "latex",
-  file_patterns = { "%.tex$", "%.bib$" , "%.dtx$", "%.sty$", "%.ins$", "%.cls$" },
-  command = { 'texlab' }
-}
-
----# TOML - Taplo
+---# TOML - taplo
 --- __Status__: Works
 --- __Site__: https://github.com/tamasfe/taplo
 --- __Installation__: 'sudo pacman -S taplo-cli'
@@ -848,7 +838,7 @@ lspconfig.taplo = add_lsp {
   verbose = false
 }
 
----# typescript-language-server
+---# Typescript - typescript-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/typescript-language-server/typescript-language-server
 --- __Installation__: `npm install -g typescript-language-server typescript`
@@ -865,7 +855,7 @@ lspconfig.tsserver = add_lsp {
   verbose = false
 }
 
----# typst-lsp 
+---# Typst - typst-lsp 
 --- __Status: Works
 --- __Site__: https://github.com/nvarner/typst-lsp
 --- __Instalation__: `yay typst-lsp-bin`
@@ -881,19 +871,7 @@ lspconfig.typst_lsp = add_lsp {
   }
 }
 
----# vim-language-server
---- __Status__: Untested
---- __Site__: https://github.com/iamcco/vim-language-server
---- __Installation__: `npm install -g vim-language-server`
-lspconfig.vimls = add_lsp {
-  name = "vim-language-server",
-  language = "vim",
-  file_patterns = { "%.vim$" },
-  command = { 'vim-language-server', '--stdio' },
-  verbose = false
-}
-
----# V
+---# V - v-analyzer
 --- __Status__: Works
 --- __Site__: https://github.com/vlang/v-analyzer
 --- __Installation__: https://github.com/vlang/v-analyzer?tab=readme-ov-file#installation
@@ -905,6 +883,18 @@ lspconfig.v_analyzer = add_lsp {
   verbose = false
 }
 
+---# V - vlang-vls
+--- __Status__: doesn't respond to completion requests (no longer officially maintained in favor of v-analyzer)
+--- __Site__: https://github.com/vlang/vls
+--- __Installation__: https://github.com/vlang/vls?tab=readme-ov-file#installation
+lspconfig.vls = add_lsp {
+  name = "vlang-vls",
+  language = "v",
+  file_patterns = { "%.vv?$", "%.vsh$" },
+  command = { 'vlang-vls' },
+  verbose = false
+}
+
 ---# Vala - vala-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/vala-lang/vala-language-server
@@ -917,19 +907,31 @@ lspconfig.vala_ls = add_lsp {
   verbose = false
 }
 
----# vlang-vls
---- __Status__: doesn't respond to completion requests (no longer officially maintained in favor of v-analyzer)
---- __Site__: https://github.com/vlang/vls
---- __Installation__: https://github.com/vlang/vls?tab=readme-ov-file#installation
-lspconfig.vls = add_lsp {
-  name = "vlang-vls",
-  language = "v",
-  file_patterns = { "%.vv?$", "%.vsh$" },
-  command = { 'vlang-vls' },
+---# Vim - vim-language-server
+--- __Status__: Untested
+--- __Site__: https://github.com/iamcco/vim-language-server
+--- __Installation__: `npm install -g vim-language-server`
+lspconfig.vimls = add_lsp {
+  name = "vim-language-server",
+  language = "vim",
+  file_patterns = { "%.vim$" },
+  command = { 'vim-language-server', '--stdio' },
+  verbose = false
+}
+
+---# XML - lemminx
+--- __Status__: Works
+--- __Site__: https://github.com/eclipse/lemminx
+--- __Installation__: 'paru -S lemminx'
+lspconfig.lemminx = add_lsp {
+  name = "lemminx",
+  language = "xml",
+  file_patterns = { "%.xml$" },
+  command = { "lemminx" },
   verbose = false
 }
 
----# yaml-language-server
+---# YAML - yaml-language-server
 --- __Status__: Untested
 --- __Site__: https://github.com/redhat-developer/yaml-language-server
 --- __Installation__: See official website for instructions
@@ -941,7 +943,7 @@ lspconfig.yamlls = add_lsp {
   verbose = false
 }
 
----# Zig Language Server
+---# Zig - zls
 --- __Status__: Untested
 --- __Site__: https://github.com/zigtools/zls
 --- __Installation__: See official website for instructions

From 0d3c9e8bbd1362ee7432672e1e2a5029e07e6ad4 Mon Sep 17 00:00:00 2001
From: PerilousBooklet <raffaele.orabona@protonmail.com>
Date: Sat, 14 Dec 2024 15:43:56 +0100
Subject: [PATCH 2/7] Tidied up installation instructions links.

---
 config.lua | 101 ++++++++++++++++++++++-------------------------------
 1 file changed, 42 insertions(+), 59 deletions(-)

diff --git a/config.lua b/config.lua
index ede9793..c1825a9 100644
--- a/config.lua
+++ b/config.lua
@@ -86,8 +86,7 @@ local lspconfig = {}
 ---# Bash - bash-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/bash-lsp/bash-language-server
---- __Installation__: `npm i -g bash-language-server`
---- __Note__: also install `shellcheck` for linting
+--- __Installation__: https://github.com/bash-lsp/bash-language-server?tab=readme-ov-file#installation
 lspconfig.bashls = add_lsp {
   name = "bash-language-server",
   language = "shellscript",
@@ -100,7 +99,7 @@ lspconfig.bashls = add_lsp {
 ---# C/C++ - ccls
 --- __Status__: Works
 --- __Site__: https://github.com/MaskRay/ccls/
---- __Installation__: https://github.com/MaskRay/ccls/wiki
+--- __Installation__: https://github.com/MaskRay/ccls/wiki/Install
 lspconfig.ccls = add_lsp {
   name = "ccls",
   language = {
@@ -141,7 +140,7 @@ lspconfig.clangd = add_lsp {
 }
 
 ---# Clojure - clojure-lsp
---- __Status__: Untested
+--- __Status__: Works
 --- __Site__: https://clojure-lsp.github.io/
 --- __Installation__: https://clojure-lsp.github.io/clojure-lsp/installation/
 lspconfig.clojure_lsp = add_lsp {
@@ -155,7 +154,7 @@ lspconfig.clojure_lsp = add_lsp {
 ---# Crystal - crystalline
 --- __Status__: Works
 --- __Site__: https://github.com/elbywan/crystalline
---- __Installation__: 'paru -S crystalline-bin'
+--- __Installation__: https://github.com/elbywan/crystalline?tab=readme-ov-file#installation
 lspconfig.crystalline = add_lsp {
   name = "crystalline",
   language = "crystal",
@@ -167,8 +166,7 @@ lspconfig.crystalline = add_lsp {
 ---# CSS - vscode-css-languageserver
 --- __Status__: Works
 --- __Site__: https://github.com/vscode-langservers/vscode-css-languageserver-bin
---- __Installation__: `npm install -g vscode-css-languageserver-bin`
----                   or `pacman -S vscode-css-languageserver`
+--- __Installation__: https://github.com/vscode-langservers/vscode-css-languageserver-bin?tab=readme-ov-file#installing
 lspconfig.cssls = add_lsp {
   name = "css-languageserver",
   language = "css",
@@ -188,7 +186,7 @@ lspconfig.cssls = add_lsp {
 ---# C# - omnisharp
 --- __Status__: Works but, freeze on large projects (https://github.com/ppy/osu.git)
 --- __Site__: https://github.com/OmniSharp/omnisharp-roslyn
---- __Installation__: See official website for instructions
+--- __Installation__: https://github.com/OmniSharp/omnisharp-roslyn?tab=readme-ov-file#downloading-omnisharp
 lspconfig.omnisharp = add_lsp {
   name = "omnisharp",
   language = "csharp",
@@ -210,7 +208,7 @@ lspconfig.serve_d = add_lsp {
 }
 
 ---# Dart - dartls
---- __Status__: Untested
+--- __Status__: Works
 --- __Site__: https://github.com/dart-lang/sdk
 --- __Installation__: Provided in dart sdk
 lspconfig.dartls = add_lsp {
@@ -270,7 +268,7 @@ lspconfig.deno = add_lsp {
 ---# Dockerfile - dockerfile-language-server-nodejs
 --- __Status__: Untested
 --- __Site__: https://github.com/rcjsuen/dockerfile-language-server-nodejs
---- __Installation__: `npm install -g dockerfile-language-server-nodejs`
+--- __Installation__: https://github.com/rcjsuen/dockerfile-language-server?tab=readme-ov-file#installation-instructions
 lspconfig.dockerls = add_lsp {
   name = "docker-langserver",
   language = "dockerfile",
@@ -283,6 +281,7 @@ lspconfig.dockerls = add_lsp {
 --- __Status__: Works
 --- __Site__: https://github.com/elixir-lsp/elixir-ls
 --- __Installation__: 'paru -S elixir-ls'
+--- __Note: https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=elixir-ls
 lspconfig.elixirls = add_lsp {
   name = "elixirls",
   language = "elixir",
@@ -292,9 +291,9 @@ lspconfig.elixirls = add_lsp {
 }
 
 ---# Elm - elm-language-server
---- __Status__: Untested
+--- __Status__: Works
 --- __Site__: https://github.com/elm-tooling/elm-language-server
---- __Installation__: `paru -S elm-language-server`
+--- __Installation__: https://github.com/elm-tooling/elm-language-server?tab=readme-ov-file#installation
 lspconfig.elmls = add_lsp {
   name = "elmls",
   language = "elm",
@@ -304,9 +303,9 @@ lspconfig.elmls = add_lsp {
 }
 
 ---# Erlang - erlang_ls
---- __Status__: Untested
+--- __Status__: Works
 --- __Site__: https://github.com/erlang-ls/erlang_ls
---- __Installation__: ?
+--- __Installation__: https://github.com/erlang-ls/erlang_ls?tab=readme-ov-file#quickstart
 lspconfig.erlangls = add_lsp {
   name = "erlangls",
   language = "erlang",
@@ -316,14 +315,9 @@ lspconfig.erlangls = add_lsp {
 }
 
 ---# Fennel - fennel-ls
---- __Status__: Untested
+--- __Status__: Works
 --- __Site__: https://git.sr.ht/~xerool/fennel-ls
---- __Installation__:
---- ```sh
---- git clone https://git.sr.ht/~xerool/fennel-ls
---- make -C fennel-ls
---- sudo make -C fennel-ls install
---- ```
+--- __Installation__: https://git.sr.ht/~xerool/fennel-ls/tree/main/docs/manual.md#installation
 lspconfig.fennells = add_lsp {
   name = "fennel-ls",
   language = "fennel",
@@ -335,7 +329,7 @@ lspconfig.fennells = add_lsp {
 ---# Fortran - fortls
 --- __Status__: Works
 --- __Site__: https://fortls.fortran-lang.org/index.html
---- __Installation__: `paru -S fortls`
+--- __Installation__: https://fortls.fortran-lang.org/quickstart.html
 lspconfig.fortls = add_lsp {
   name = "fortls",
   language = "fortran",
@@ -359,7 +353,7 @@ lspconfig.gleam = add_lsp {
 ---# Go - gopls
 --- __Status__: Works
 --- __Site__: https://pkg.go.dev/golang.org/x/tools/gopls
---- __Installation__: `go get -u golang.org/x/tools/gopls`
+--- __Installation__: https://pkg.go.dev/golang.org/x/tools/gopls#readme-installation
 lspconfig.gopls = add_lsp {
   name = "gopls",
   language = "go",
@@ -391,8 +385,7 @@ lspconfig.groovyls = add_lsp {
 ---# Haskell - haskell-language-server
 --- __Status__: Untested
 --- __Site__: https://github.com/haskell/haskell-language-server
---- __Installation__: `ghcup install hls`
---- or https://github.com/haskell/haskell-language-server#installation
+--- __Installation__: https://haskell-language-server.readthedocs.io/en/latest/installation.html
 lspconfig.hls = add_lsp {
   name = "haskell-language-server",
   language = "haskell",
@@ -404,8 +397,7 @@ lspconfig.hls = add_lsp {
 ---# HTML - vscode-html-languageserver
 --- __Status__: Works
 --- __Site__: https://github.com/vscode-langservers/vscode-html-languageserver-bin
---- __Installation__: `npm install --global vscode-html-languageserver-bin`
----                   or `pacman -S vscode-html-languageserver`
+--- __Installation__: https://github.com/vscode-langservers/vscode-html-languageserver-bin?tab=readme-ov-file#installing
 lspconfig.html = add_lsp {
   name = "html-languageserver",
   language = "html",
@@ -447,7 +439,7 @@ lspconfig.flow = add_lsp {
 ---# Javascript - quick-lint-js
 --- __Status__: Works
 --- __Site__: https://github.com/quick-lint/quick-lint-js
---- __Installation__: Arch Linux: `yay -Syu quick-lint-js`
+--- __Installation__: https://github.com/quick-lint/quick-lint-js?tab=readme-ov-file#installing
 lspconfig.quicklintjs = add_lsp {
   name = "quick-lint-js",
   language = {
@@ -466,8 +458,7 @@ lspconfig.quicklintjs = add_lsp {
 ---# JSON - vscode-json-languageserver
 --- __Status__: Works
 --- __Site__: https://www.npmjs.com/package/vscode-json-languageserver
---- __Installation__: `npm install -g vscode-json-languageserver`
----                   or `pacman -S vscode-json-languageserver`
+--- __Installation__: `npm install vscode-json-languageserver`
 lspconfig.jsonls = add_lsp {
   name = "json-languageserver",
   language = "json",
@@ -484,9 +475,9 @@ lspconfig.jsonls = add_lsp {
 }
 
 ---# Kotlin - kotlin-language-server
---- __Status__: Untested
+--- __Status__: Works
 --- __Site__: https://github.com/fwcd/kotlin-language-server
---- __Installation__: https://github.com/fwcd/kotlin-language-server/releases
+--- __Installation__: 'paru -S kotlin-language-server'
 lspconfig.kotlin_language_server = add_lsp {
   name = "kotlin-language-server",
   language = "kotlin",
@@ -498,8 +489,7 @@ lspconfig.kotlin_language_server = add_lsp {
 ---# LaTeX - texlab
 --- __Status__: Works
 --- __Site__: https://github.com/latex-lsp/texlab
---- __Installation__: git clone https://github.com/latex-lsp/texlab.git , then inside the texlab folder, run: cargo build --release
---- __Note__: Rust has to be installed
+--- __Installation__: https://github.com/latex-lsp/texlab?tab=readme-ov-file#requirements
 lspconfig.texlab = add_lsp {
   name = "texlab",
   language = "latex",
@@ -567,10 +557,9 @@ lspconfig.sumneko_lua = add_lsp {
 }
 
 ---# Nix - nil
---- __Status__:       Works
---- __Site__:         https://github.com/oxalica/nil
---- __Installation__: cargo install --git https://github.com/oxalica/nil nil
---- __Note__:         nix >= 2.4 needs to be installed
+--- __Status__: Works
+--- __Site__: https://github.com/oxalica/nil
+--- __Installation__: https://github.com/oxalica/nil?tab=readme-ov-file#installation
 lspconfig.nillsp = add_lsp {
   name = "nil",
   language = "nix",
@@ -582,7 +571,7 @@ lspconfig.nillsp = add_lsp {
 ---# Nim - nimlsp
 --- __Status__: Works
 --- __Site__: https://github.com/PMunch/nimlsp
---- __Installation__: `nimble install nimlsp`
+--- __Installation__: https://github.com/PMunch/nimlsp?tab=readme-ov-file#installing-nimlsp
 lspconfig.nimlsp = add_lsp {
   name = "nimlsp",
   language = "nim",
@@ -608,7 +597,7 @@ lspconfig.ocaml_lsp = add_lsp {
 ---# Odin - ols
 --- __Status__: Works
 --- __Site__: https://github.com/DanielGavin/ols
---- __Installation__: `paru -S odinls`
+--- __Installation__: https://github.com/DanielGavin/ols?tab=readme-ov-file#installation
 lspconfig.odinls = add_lsp {
   name = "odinls",
   language = "odin",
@@ -620,7 +609,7 @@ lspconfig.odinls = add_lsp {
 ---# Perl - PerlNavigator
 --- __Status__: Works
 --- __Site__: https://github.com/bscan/PerlNavigator
---- __Installation__: `paru -S perlnavigator`
+--- __Installation__: https://github.com/bscan/PerlNavigator?tab=readme-ov-file#installation-for-other-editors
 lspconfig.perlnavigator = add_lsp {
   name = "perlnavigator",
   language = "perl",
@@ -653,9 +642,7 @@ lspconfig.intelephense = add_lsp {
 ---# Python - python-language-server
 --- __Status__: Works (deprecated in favor of python-lsp-server)
 --- __Site__: https://github.com/palantir/python-language-server
---- __Installation__: `pip install python-language-server`
---- __Note__: Also don't forget to install any additional optional dependencies
---- for additional features (see official site for details).
+--- __Installation__: https://github.com/palantir/python-language-server?tab=readme-ov-file#installation
 lspconfig.pyls = add_lsp {
   name = "pyls",
   language = "python",
@@ -667,9 +654,7 @@ lspconfig.pyls = add_lsp {
 ---# Python - python-lsp-server
 --- __Status__: Works
 --- __Site__: https://github.com/python-lsp/python-lsp-server
---- __Installation__: `pip install python-lsp-server`
---- __Note__: Also don't forget to install any additional optional dependencies
---- for additional features (see official site for details).
+--- __Installation__: https://github.com/python-lsp/python-lsp-server?tab=readme-ov-file#installation
 lspconfig.pylsp = add_lsp {
   name = "pylsp",
   language = "python",
@@ -705,9 +690,7 @@ lspconfig.rlanguageserver = add_lsp {
 ---# Ruby - ruby-lsp
 --- __Status__: Untested
 --- __Site__: https://github.com/Shopify/ruby-lsp
---- __Instalation__: gem install ruby-lsp
---- __Note__: Also don't forget to install any additional optional dependecies
---- for additional features (see official site for details).
+--- __Instalation__: https://github.com/Shopify/ruby-lsp?tab=readme-ov-file#getting-started
 lspconfig.ruby_lsp = add_lsp {
   name = "ruby-lsp",
   language = "ruby",
@@ -742,7 +725,7 @@ lspconfig.ruby_lsp = add_lsp {
 ---# Rust - rls
 --- __Status__: Works
 --- __Site__: https://github.com/rust-lang/rls
---- __Installation__: Install rust on your system
+--- __Installation__: https://github.com/rust-lang/rls?tab=readme-ov-file#setup
 lspconfig.rls = add_lsp {
   name = "rust-language-server",
   language = "rust",
@@ -754,7 +737,7 @@ lspconfig.rls = add_lsp {
 ---# Rust - rust-analyzer
 --- __Status__: Works
 --- __Site__: https://rust-analyzer.github.io/
---- __Installation__: See official website for instructions
+--- __Installation__: https://rust-analyzer.github.io/manual.html#installation
 lspconfig.rust_analyzer = add_lsp {
   name = "rust-analyzer",
   language = "rust",
@@ -766,7 +749,7 @@ lspconfig.rust_analyzer = add_lsp {
 ---# Scala - metals
 --- __Status__: Works
 --- __Site__: https://scalameta.org/metals/
---- __Installation__: `paru -S metals`
+--- __Installation__: https://scalameta.org/metals/docs#installation
 lspconfig.metals = add_lsp {
   name = "metals",
   language = "scala",
@@ -790,7 +773,7 @@ lspconfig.solargraph = add_lsp {
 ---# SQL - sql-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/joe-re/sql-language-server
---- __Installation__: `npm i -g sql-language-server`
+--- __Installation__: https://github.com/joe-re/sql-language-server?tab=readme-ov-file#installation--how-to-setup
 lspconfig.sqlls = add_lsp {
   name = "sql-language-server",
   language = "sql",
@@ -841,7 +824,7 @@ lspconfig.taplo = add_lsp {
 ---# Typescript - typescript-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/typescript-language-server/typescript-language-server
---- __Installation__: `npm install -g typescript-language-server typescript`
+--- __Installation__: https://github.com/typescript-language-server/typescript-language-server?tab=readme-ov-file#installing
 lspconfig.tsserver = add_lsp {
   name = "typescript-language-server",
   language = {
@@ -898,7 +881,7 @@ lspconfig.vls = add_lsp {
 ---# Vala - vala-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/vala-lang/vala-language-server
---- __Installation__: `paru -S vala-language-server`
+--- __Installation__: https://github.com/vala-lang/vala-language-server?tab=readme-ov-file#installation
 lspconfig.vala_ls = add_lsp {
   name = "vala_ls",
   language = "vala",
@@ -910,7 +893,7 @@ lspconfig.vala_ls = add_lsp {
 ---# Vim - vim-language-server
 --- __Status__: Untested
 --- __Site__: https://github.com/iamcco/vim-language-server
---- __Installation__: `npm install -g vim-language-server`
+--- __Installation__: https://github.com/iamcco/vim-language-server?tab=readme-ov-file#install
 lspconfig.vimls = add_lsp {
   name = "vim-language-server",
   language = "vim",
@@ -934,7 +917,7 @@ lspconfig.lemminx = add_lsp {
 ---# YAML - yaml-language-server
 --- __Status__: Untested
 --- __Site__: https://github.com/redhat-developer/yaml-language-server
---- __Installation__: See official website for instructions
+--- __Installation__: 'sudo pacman -Syu yaml-language-server'
 lspconfig.yamlls = add_lsp {
   name = "yaml-language-server",
   language = "yaml",
@@ -946,7 +929,7 @@ lspconfig.yamlls = add_lsp {
 ---# Zig - zls
 --- __Status__: Untested
 --- __Site__: https://github.com/zigtools/zls
---- __Installation__: See official website for instructions
+--- __Installation__: https://zigtools.org/zls/install/
 lspconfig.zls = add_lsp {
   name = "zls",
   language = "zig",

From cca44902bf9b55729a642d908d8d5a24db5b9690 Mon Sep 17 00:00:00 2001
From: PerilousBooklet <raffaele.orabona@protonmail.com>
Date: Sun, 23 Mar 2025 13:50:07 +0100
Subject: [PATCH 3/7] Removed redundant comment.

---
 config.lua | 2 --
 1 file changed, 2 deletions(-)

diff --git a/config.lua b/config.lua
index c1825a9..0bf7965 100644
--- a/config.lua
+++ b/config.lua
@@ -81,8 +81,6 @@ end
 ---@class lsp.config
 local lspconfig = {}
 
--- NOTE: the sorting will occur in the following order: prog_lang_name, LSP_server_name
-
 ---# Bash - bash-language-server
 --- __Status__: Works
 --- __Site__: https://github.com/bash-lsp/bash-language-server

From 440be6c7c458abdb33fc7a3a192e3b6a034ab712 Mon Sep 17 00:00:00 2001
From: PerilousBooklet <raffaele.orabona@protonmail.com>
Date: Thu, 15 May 2025 21:56:18 +0200
Subject: [PATCH 4/7] Reorganized LSP-server-specific description standards,
 following consultation with Guldoman.

---
 config.lua | 232 ++++++++++++++++++++++++++---------------------------
 1 file changed, 116 insertions(+), 116 deletions(-)

diff --git a/config.lua b/config.lua
index a520e22..c1ae13e 100644
--- a/config.lua
+++ b/config.lua
@@ -81,12 +81,12 @@ end
 ---@class lsp.config
 local lspconfig = {}
 
----# Bash - bash-language-server
+---# Bash - bash_ls
 --- __Status__: Works
 --- __Site__: https://github.com/bash-lsp/bash-language-server
 --- __Installation__: https://github.com/bash-lsp/bash-language-server?tab=readme-ov-file#installation
-lspconfig.bashls = add_lsp {
-  name = "bash-language-server",
+lspconfig.bash_ls = add_lsp {
+  name = "bash_ls",
   language = "shellscript",
   file_patterns = { "%.sh$" },
   command = { "bash-language-server", "start" },
@@ -137,12 +137,12 @@ lspconfig.clangd = add_lsp {
   verbose = false
 }
 
----# Clojure - clojure-lsp
+---# Clojure - clojure_lsp
 --- __Status__: Works
 --- __Site__: https://clojure-lsp.github.io/
 --- __Installation__: https://clojure-lsp.github.io/clojure-lsp/installation/
 lspconfig.clojure_lsp = add_lsp {
-  name = "clojure-lsp",
+  name = "clojure_lsp",
   language = "clojure",
   file_patterns = { "%.clj$", "%.cljs$", "%.clc$", "%.edn$" },
   command = { "clojure-lsp" },
@@ -161,12 +161,12 @@ lspconfig.crystalline = add_lsp {
   verbose = false
 }
 
----# CSS - vscode-css-languageserver
+---# CSS - vscode_css_ls
 --- __Status__: Works
 --- __Site__: https://github.com/vscode-langservers/vscode-css-languageserver-bin
 --- __Installation__: https://github.com/vscode-langservers/vscode-css-languageserver-bin?tab=readme-ov-file#installing
-lspconfig.cssls = add_lsp {
-  name = "css-languageserver",
+lspconfig.vscode_css_ls = add_lsp {
+  name = "vscode_css_ls",
   language = "css",
   file_patterns = { "%.css$", "%.less$", "%.sass$" },
   command = {
@@ -182,7 +182,7 @@ lspconfig.cssls = add_lsp {
 }
 
 ---# C# - omnisharp
---- __Status__: Works but, freeze on large projects (https://github.com/ppy/osu.git)
+--- __Status__: Works, but freezes on large projects (https://github.com/ppy/osu.git)
 --- __Site__: https://github.com/OmniSharp/omnisharp-roslyn
 --- __Installation__: https://github.com/OmniSharp/omnisharp-roslyn?tab=readme-ov-file#downloading-omnisharp
 lspconfig.omnisharp = add_lsp {
@@ -193,7 +193,7 @@ lspconfig.omnisharp = add_lsp {
   verbose = false
 }
 
----# D - serve-d
+---# D - serve_d
 --- __Status__: Works
 --- __Site__: https://github.com/Pure-D/serve-d
 --- __Installation__: https://github.com/Pure-D/serve-d?tab=readme-ov-file#installation
@@ -210,19 +210,19 @@ lspconfig.serve_d = add_lsp {
 --- __Site__: https://github.com/dart-lang/sdk
 --- __Installation__: Provided in dart sdk
 lspconfig.dartls = add_lsp {
-  name = "dart",
+  name = "dartls",
   language = "dart",
   file_patterns = { "%.dart$" },
   command = { "dart", "language-server", "--protocol=lsp" },
   verbose = false
 }
 
----# Deno
+---# Deno - deno_ls
 --- __Status__: Works
 --- __Site__: https://deno.land/manual/advanced/language_server
 --- __Installation__: Provided in Deno runtime
-lspconfig.deno = add_lsp {
-  name = "deno",
+lspconfig.deno_ls = add_lsp {
+  name = "deno_ls",
   language = {
     { id = "javascript",      pattern = "%.js$"  },
     { id = "javascriptreact", pattern = "%.jsx$" },
@@ -263,37 +263,37 @@ lspconfig.deno = add_lsp {
   }
 }
 
----# Dockerfile - dockerfile-language-server-nodejs
+---# Dockerfile - dockerfile_ls_nodejs
 --- __Status__: Untested
 --- __Site__: https://github.com/rcjsuen/dockerfile-language-server-nodejs
 --- __Installation__: https://github.com/rcjsuen/dockerfile-language-server?tab=readme-ov-file#installation-instructions
-lspconfig.dockerls = add_lsp {
-  name = "docker-langserver",
+lspconfig.dockerfile_ls_nodejs = add_lsp {
+  name = "dockerfile_ls_nodejs",
   language = "dockerfile",
   file_patterns = { "Dockerfile$" },
   command = { "docker-langserver", "--stdio" },
   verbose = false
 }
 
----# Elixir - elixir-ls
+---# Elixir - elixir_ls
 --- __Status__: Works
 --- __Site__: https://github.com/elixir-lsp/elixir-ls
 --- __Installation__: 'paru -S elixir-ls'
 --- __Note: https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=elixir-ls
-lspconfig.elixirls = add_lsp {
-  name = "elixirls",
+lspconfig.elixir_ls = add_lsp {
+  name = "elixir_ls",
   language = "elixir",
   file_patterns = { "%.ex$", "%.exs$" },
   command = { "elixir-ls" },
   verbose = false
 }
 
----# Elm - elm-language-server
+---# Elm - elm_ls
 --- __Status__: Works
 --- __Site__: https://github.com/elm-tooling/elm-language-server
 --- __Installation__: https://github.com/elm-tooling/elm-language-server?tab=readme-ov-file#installation
-lspconfig.elmls = add_lsp {
-  name = "elmls",
+lspconfig.elm_ls = add_lsp {
+  name = "elm_ls",
   language = "elm",
   file_patterns = { "%.elm$" },
   command = { "elm-language-server" },
@@ -304,44 +304,44 @@ lspconfig.elmls = add_lsp {
 --- __Status__: Works
 --- __Site__: https://github.com/erlang-ls/erlang_ls
 --- __Installation__: https://github.com/erlang-ls/erlang_ls?tab=readme-ov-file#quickstart
-lspconfig.erlangls = add_lsp {
-  name = "erlangls",
+lspconfig.erlang_ls = add_lsp {
+  name = "erlang_ls",
   language = "erlang",
   file_patterns = { "%.erl$", "%.hrl$" },
   command = { 'Erlang', 'LS', '-t', 'stdio' },
   verbose = false
 }
 
----# Fennel - fennel-ls
+---# Fennel - fennel_ls
 --- __Status__: Works
 --- __Site__: https://git.sr.ht/~xerool/fennel-ls
 --- __Installation__: https://git.sr.ht/~xerool/fennel-ls/tree/main/docs/manual.md#installation
-lspconfig.fennells = add_lsp {
-  name = "fennel-ls",
+lspconfig.fennel_ls = add_lsp {
+  name = "fennel_ls",
   language = "fennel",
   file_patterns = { "%.fnl$" },
   command = { "fennel-ls" },
   verbose = false
 }
 
----# Fortran - fortls
+---# Fortran - fort_ls
 --- __Status__: Works
 --- __Site__: https://fortls.fortran-lang.org/index.html
 --- __Installation__: https://fortls.fortran-lang.org/quickstart.html
-lspconfig.fortls = add_lsp {
-  name = "fortls",
+lspconfig.fort_ls = add_lsp {
+  name = "fort_ls",
   language = "fortran",
   file_patterns = { "%.f$", "%.f90$", "%.f95$", "%.F$" },
   command = { "fortls", "--notify_init" },
   verbose = false
 }
 
----# Gleam
+---# Gleam - gleam_ls
 --- __Status__: Works (the gleam lsp itself acts kinda weird)
 --- __Site__: https://gleam.run/
 --- __Installation__: Included with the gleam compiler binary
-lspconfig.gleam = add_lsp {
-	name = "gleam",
+lspconfig.gleam_ls = add_lsp {
+	name = "gleam_ls",
 	language = "gleam",
 	file_patterns = { "%.gleam$" },
 	command = { "gleam", "lsp" },
@@ -360,7 +360,7 @@ lspconfig.gopls = add_lsp {
   verbose = false
 }
 
----# Groovy - groovy-language-server
+---# Groovy - groovy_ls
 --- __Status__: Untested
 --- __Site__: https://github.com/prominic/groovy-language-server
 --- __Installation__:
@@ -371,8 +371,8 @@ lspconfig.gopls = add_lsp {
 --- cd ~/lsp/groovy-language-server
 --- ./gradlew build
 --- ```
-lspconfig.groovyls = add_lsp {
-  name = "groovy-language-server",
+lspconfig.groovy_ls = add_lsp {
+  name = "groovy_ls",
   language = "groovy",
   file_patterns = { "%.groovy$", "%.gvy$", "%.gy$", "%.gsh$" },
   -- command = { "java", "-jar", "/path/to/groovy-language-server-all.jar" },
@@ -380,24 +380,24 @@ lspconfig.groovyls = add_lsp {
   verbose = false
 }
 
----# Haskell - haskell-language-server
+---# Haskell - haskell_ls
 --- __Status__: Untested
 --- __Site__: https://github.com/haskell/haskell-language-server
 --- __Installation__: https://haskell-language-server.readthedocs.io/en/latest/installation.html
-lspconfig.hls = add_lsp {
-  name = "haskell-language-server",
+lspconfig.haskell_ls = add_lsp {
+  name = "haskell_ls",
   language = "haskell",
   file_patterns = { "%.hs$", "%.lhs$" },
   command = { 'haskell-language-server-wrapper', '--lsp' },
   verbose = false
 }
 
----# HTML - vscode-html-languageserver
+---# HTML - vscode_html_ls
 --- __Status__: Works
 --- __Site__: https://github.com/vscode-langservers/vscode-html-languageserver-bin
 --- __Installation__: https://github.com/vscode-langservers/vscode-html-languageserver-bin?tab=readme-ov-file#installing
-lspconfig.html = add_lsp {
-  name = "html-languageserver",
+lspconfig.vscode_html_ls = add_lsp {
+  name = "vscode_html_ls",
   language = "html",
   file_patterns = { "%.html$" },
   command = {
@@ -434,12 +434,12 @@ lspconfig.flow = add_lsp {
   verbose = false
 }
 
----# Javascript - quick-lint-js
+---# Javascript - quick_lint_js
 --- __Status__: Works
 --- __Site__: https://github.com/quick-lint/quick-lint-js
 --- __Installation__: https://github.com/quick-lint/quick-lint-js?tab=readme-ov-file#installing
-lspconfig.quicklintjs = add_lsp {
-  name = "quick-lint-js",
+lspconfig.quick_lint_js = add_lsp {
+  name = "quick_lint_js",
   language = {
     { id = "javascriptreact",      pattern = "%.jsx$"   },
     { id = "javascript",           pattern = "%.js$"    },
@@ -453,12 +453,12 @@ lspconfig.quicklintjs = add_lsp {
   verbose = false
 }
 
----# JSON - vscode-json-languageserver
+---# JSON - vscode_json_ls
 --- __Status__: Works
 --- __Site__: https://www.npmjs.com/package/vscode-json-languageserver
 --- __Installation__: `npm install vscode-json-languageserver`
-lspconfig.jsonls = add_lsp {
-  name = "json-languageserver",
+lspconfig.vscode_json_ls = add_lsp {
+  name = "vscode_json_ls",
   language = "json",
   file_patterns = { "%.json$", "%.jsonc$" },
   command = {
@@ -472,12 +472,12 @@ lspconfig.jsonls = add_lsp {
   verbose = false
 }
 
----# Kotlin - kotlin-language-server
+---# Kotlin - kotlin_ls
 --- __Status__: Works
 --- __Site__: https://github.com/fwcd/kotlin-language-server
 --- __Installation__: 'paru -S kotlin-language-server'
-lspconfig.kotlin_language_server = add_lsp {
-  name = "kotlin-language-server",
+lspconfig.kotlin_ls = add_lsp {
+  name = "kotlin_ls",
   language = "kotlin",
   file_patterns = { "%.kt$", "%.kts$", "%.ktm$" },
   command = { 'kotlin-language-server' },
@@ -495,12 +495,12 @@ lspconfig.texlab = add_lsp {
   command = { 'texlab' }
 }
 
----# Lua - lua-language-server
+---# Lua - lua_ls
 --- __Status__: Works
 --- __Site__: https://github.com/sumneko/lua-language-server
 --- __Installation__: https://github.com/sumneko/lua-language-server/wiki/Build-and-Run-(Standalone)
-lspconfig.sumneko_lua = add_lsp {
-  name = "lua-language-server",
+lspconfig.lua_ls = add_lsp {
+  name = "lua_ls",
   language = "lua",
   file_patterns = { "%.lua$" },
   command = { 'lua-language-server' },
@@ -566,12 +566,12 @@ lspconfig.marksman = add_lsp {
   verbose = false
 }
 
----# Nix - nil
+---# Nix - nil_ls
 --- __Status__: Works
 --- __Site__: https://github.com/oxalica/nil
 --- __Installation__: https://github.com/oxalica/nil?tab=readme-ov-file#installation
-lspconfig.nillsp = add_lsp {
-  name = "nil",
+lspconfig.nil_ls = add_lsp {
+  name = "nil_ls",
   language = "nix",
   file_patterns = { "%.nix$" },
   command = { "nil" },
@@ -592,12 +592,12 @@ lspconfig.nimlsp = add_lsp {
   verbose = false
 }
 
----# Ocaml - ocaml-lsp
+---# Ocaml - ocaml_lsp
 --- __Status__: Reported working on https://github.com/jgmdev/lite-xl-lsp/issues/17
 --- __Site__: https://github.com/ocaml/ocaml-lsp
 --- __Installation__: https://github.com/ocaml/ocaml-lsp#installation
 lspconfig.ocaml_lsp = add_lsp {
-  name = "ocaml-lsp",
+  name = "ocaml_lsp",
   language = "ocaml",
   file_patterns = { "%.ml$", "%.mli$" },
   command = { "ocamllsp" },
@@ -608,15 +608,15 @@ lspconfig.ocaml_lsp = add_lsp {
 --- __Status__: Works
 --- __Site__: https://github.com/DanielGavin/ols
 --- __Installation__: https://github.com/DanielGavin/ols?tab=readme-ov-file#installation
-lspconfig.odinls = add_lsp {
-  name = "odinls",
+lspconfig.ols = add_lsp {
+  name = "ols",
   language = "odin",
   file_patterns = { "%.odin$" },
   command = { "ols" },
   verbose = false
 }
 
----# Perl - PerlNavigator
+---# Perl - perlnavigator
 --- __Status__: Works
 --- __Site__: https://github.com/bscan/PerlNavigator
 --- __Installation__: https://github.com/bscan/PerlNavigator?tab=readme-ov-file#installation-for-other-editors
@@ -649,24 +649,24 @@ lspconfig.intelephense = add_lsp {
   verbose = false
 }
 
----# Python - python-language-server
+---# Python - python_ls_palantir
 --- __Status__: Works (deprecated in favor of python-lsp-server)
 --- __Site__: https://github.com/palantir/python-language-server
 --- __Installation__: https://github.com/palantir/python-language-server?tab=readme-ov-file#installation
-lspconfig.pyls = add_lsp {
-  name = "pyls",
+lspconfig.python_ls_palantir = add_lsp {
+  name = "python_ls_palantir",
   language = "python",
   file_patterns = { "%.py$" },
   command = { 'pyls' },
   verbose = false
 }
 
----# Python - python-lsp-server
+---# Python - python_ls
 --- __Status__: Works
 --- __Site__: https://github.com/python-lsp/python-lsp-server
 --- __Installation__: https://github.com/python-lsp/python-lsp-server?tab=readme-ov-file#installation
-lspconfig.pylsp = add_lsp {
-  name = "pylsp",
+lspconfig.python_ls = add_lsp {
+  name = "python_ls",
   language = "python",
   file_patterns = { "%.py$" },
   command = { 'pylsp' },
@@ -685,24 +685,24 @@ lspconfig.pyright = add_lsp {
   verbose = false
 }
 
----# R
+---# R - r_ls
 -- __Status__: Works
 -- __Site__:https://github.com/REditorSupport/languageserver#installation
 -- __Installation__: `paru -S r-languageserver`
-lspconfig.rlanguageserver = add_lsp {
-  name = "rlanguageserver",
+lspconfig.r_ls = add_lsp {
+  name = "r_ls",
   language = "r",
   file_patterns = { "%.r$", "%.R$" },
   command = {'R', '--slave', '-e', 'languageserver::run()'},
   verbose = false
 }
 
----# Ruby - ruby-lsp
+---# Ruby - ruby_lsp
 --- __Status__: Untested
 --- __Site__: https://github.com/Shopify/ruby-lsp
 --- __Instalation__: https://github.com/Shopify/ruby-lsp?tab=readme-ov-file#getting-started
 lspconfig.ruby_lsp = add_lsp {
-  name = "ruby-lsp",
+  name = "ruby_lsp",
   language = "ruby",
   file_patterns = { "%.rb$" },
   command = { 'ruby-lsp' },
@@ -732,24 +732,36 @@ lspconfig.ruby_lsp = add_lsp {
   verbose = false
 }
 
----# Rust - rls
+---# Ruby - solargraph
+--- __Status__: Untested
+--- __Site__: https://github.com/castwide/solargraph
+--- __Installation__: `gem install solargraph`
+lspconfig.solargraph = add_lsp {
+  name = "solargraph",
+  language = "ruby",
+  file_patterns = { "%.rb$" },
+  command = { 'solargraph', 'stdio' },
+  verbose = false
+}
+
+---# Rust - rust_ls
 --- __Status__: Works
 --- __Site__: https://github.com/rust-lang/rls
 --- __Installation__: https://github.com/rust-lang/rls?tab=readme-ov-file#setup
-lspconfig.rls = add_lsp {
-  name = "rust-language-server",
+lspconfig.rust_ls = add_lsp {
+  name = "rust_ls",
   language = "rust",
   file_patterns = { "%.rs$" },
   command = { 'rls' },
   verbose = false
 }
 
----# Rust - rust-analyzer
+---# Rust - rust_analyzer
 --- __Status__: Works
 --- __Site__: https://rust-analyzer.github.io/
 --- __Installation__: https://rust-analyzer.github.io/manual.html#installation
 lspconfig.rust_analyzer = add_lsp {
-  name = "rust-analyzer",
+  name = "rust_analyzer",
   language = "rust",
   file_patterns = { "%.rs$" },
   command = { 'rust-analyzer' },
@@ -768,50 +780,38 @@ lspconfig.metals = add_lsp {
   verbose = false
 }
 
----# Solargraph
---- __Status__: Untested
---- __Site__: https://github.com/castwide/solargraph
---- __Installation__: `gem install solargraph`
-lspconfig.solargraph = add_lsp {
-  name = "solargraph",
-  language = "ruby",
-  file_patterns = { "%.rb$" },
-  command = { 'solargraph', 'stdio' },
-  verbose = false
-}
-
----# SQL - sql-language-server
+---# SQL - sql_ls
 --- __Status__: Works
 --- __Site__: https://github.com/joe-re/sql-language-server
 --- __Installation__: https://github.com/joe-re/sql-language-server?tab=readme-ov-file#installation--how-to-setup
-lspconfig.sqlls = add_lsp {
-  name = "sql-language-server",
+lspconfig.sql_ls = add_lsp {
+  name = "sql_ls",
   language = "sql",
   file_patterns = { "%.sql$" },
   command = { 'sql-language-server', 'up', '--method', 'stdio' },
   verbose = false
 }
 
----# Svelte - svelte-language-server
+---# Svelte - svelte_ls
 --- __Status__: Works
 --- __Site__: https://github.com/sveltejs/language-tools/tree/master/packages/language-server
 --- __Installation__: `npm install -g svelte-language-server`
 --- __Note__: Also don't forget to install any additional optional dependencies
 --- for additional features (see official site for details).
-lspconfig.sveltels = add_lsp {
-  name = "sveltels",
+lspconfig.svelte_ls = add_lsp {
+  name = "svelte_ls",
   language = "svelte",
   file_patterns = { "%.svelte$" },
   command = { 'svelteserver', '--stdio' },
   verbose = false
 }
 
----# Tailwind CSS
+---# Tailwind CSS - tailwind_css_ls
 --- __Status__: Broken (freezes when writing class names inside html doc, requires new implementation of json.lua)
 --- __Site__: https://github.com/tailwindlabs/tailwindcss-intellisense
 --- __Installation__: Arch Linux: `sudo pacman -S tailwindcss-language-server`
-lspconfig.tailwindcss = add_lsp {
-  name = "tailwindcss",
+lspconfig.tailwind_css_ls = add_lsp {
+  name = "tailwind_css_ls",
   language = "html",
   file_patterns = { "%.html$"},
   command = {'tailwindcss-language-server', '--stdio'},
@@ -831,12 +831,12 @@ lspconfig.taplo = add_lsp {
   verbose = false
 }
 
----# Typescript - typescript-language-server
+---# Typescript - typescript_ls
 --- __Status__: Works
 --- __Site__: https://github.com/typescript-language-server/typescript-language-server
 --- __Installation__: https://github.com/typescript-language-server/typescript-language-server?tab=readme-ov-file#installing
-lspconfig.tsserver = add_lsp {
-  name = "typescript-language-server",
+lspconfig.typescript_ls = add_lsp {
+  name = "typescript_ls",
   language = {
     { id = "javascript",      pattern = "%.[cm]?js$"  },
     { id = "javascriptreact", pattern = "%.jsx$"      },
@@ -848,12 +848,12 @@ lspconfig.tsserver = add_lsp {
   verbose = false
 }
 
----# Typst - typst-lsp 
+---# Typst - typst_lsp
 --- __Status: Works
 --- __Site__: https://github.com/nvarner/typst-lsp
 --- __Instalation__: `yay typst-lsp-bin`
 lspconfig.typst_lsp = add_lsp {
-  name = "typst-lsp",
+  name = "typst_lsp",
   language = "typst",
   file_patterns = { "%.typ$" },
   command = { 'typst-lsp' },
@@ -864,7 +864,7 @@ lspconfig.typst_lsp = add_lsp {
   }
 }
 
----# V - v-analyzer
+---# V - v_analyzer
 --- __Status__: Works
 --- __Site__: https://github.com/vlang/v-analyzer
 --- __Installation__: https://github.com/vlang/v-analyzer?tab=readme-ov-file#installation
@@ -876,19 +876,19 @@ lspconfig.v_analyzer = add_lsp {
   verbose = false
 }
 
----# V - vlang-vls
+---# V - v_ls
 --- __Status__: doesn't respond to completion requests (no longer officially maintained in favor of v-analyzer)
 --- __Site__: https://github.com/vlang/vls
 --- __Installation__: https://github.com/vlang/vls?tab=readme-ov-file#installation
-lspconfig.vls = add_lsp {
-  name = "vlang-vls",
+lspconfig.v_ls = add_lsp {
+  name = "v_ls",
   language = "v",
   file_patterns = { "%.vv?$", "%.vsh$" },
   command = { 'vlang-vls' },
   verbose = false
 }
 
----# Vala - vala-language-server
+---# Vala - vala_ls
 --- __Status__: Works
 --- __Site__: https://github.com/vala-lang/vala-language-server
 --- __Installation__: https://github.com/vala-lang/vala-language-server?tab=readme-ov-file#installation
@@ -900,12 +900,12 @@ lspconfig.vala_ls = add_lsp {
   verbose = false
 }
 
----# Vim - vim-language-server
+---# Vim - vim_ls
 --- __Status__: Untested
 --- __Site__: https://github.com/iamcco/vim-language-server
 --- __Installation__: https://github.com/iamcco/vim-language-server?tab=readme-ov-file#install
-lspconfig.vimls = add_lsp {
-  name = "vim-language-server",
+lspconfig.vim_ls = add_lsp {
+  name = "vim_ls",
   language = "vim",
   file_patterns = { "%.vim$" },
   command = { 'vim-language-server', '--stdio' },
@@ -924,12 +924,12 @@ lspconfig.lemminx = add_lsp {
   verbose = false
 }
 
----# YAML - yaml-language-server
+---# YAML - yaml_ls
 --- __Status__: Untested
 --- __Site__: https://github.com/redhat-developer/yaml-language-server
 --- __Installation__: 'sudo pacman -Syu yaml-language-server'
-lspconfig.yamlls = add_lsp {
-  name = "yaml-language-server",
+lspconfig.yaml_ls = add_lsp {
+  name = "yaml_ls",
   language = "yaml",
   file_patterns = { "%.yml$", "%.yaml$" },
   command = { 'yaml-language-server', '--stdio' },

From a6187892e368ee40bb172b073ee7c1ce6a1b3f0d Mon Sep 17 00:00:00 2001
From: PerilousBooklet <raffaele.orabona@protonmail.com>
Date: Thu, 15 May 2025 22:24:01 +0200
Subject: [PATCH 5/7] Reworked LSP-server-specific naming conventions.

---
 config.lua | 53 ++++++++++++++++++++++-------------------------------
 1 file changed, 22 insertions(+), 31 deletions(-)

diff --git a/config.lua b/config.lua
index c1ae13e..a20777d 100644
--- a/config.lua
+++ b/config.lua
@@ -81,6 +81,8 @@ end
 ---@class lsp.config
 local lspconfig = {}
 
+-- NOTE: as of 15/05/2025, the LSP-server-specific naming conventions used here are described in https://github.com/neovim/nvim-lspconfig/blob/ac1dfbe3b60e5e23a2cff90e3bd6a3bc88031a57/CONTRIBUTING.md#walkthrough:~:text=When%20choosing%20a,(jsonnet_ls).
+
 ---# Bash - bash_ls
 --- __Status__: Works
 --- __Site__: https://github.com/bash-lsp/bash-language-server
@@ -208,7 +210,7 @@ lspconfig.serve_d = add_lsp {
 ---# Dart - dartls
 --- __Status__: Works
 --- __Site__: https://github.com/dart-lang/sdk
---- __Installation__: Provided in dart sdk
+--- __Installation__: Provided by dart sdk
 lspconfig.dartls = add_lsp {
   name = "dartls",
   language = "dart",
@@ -278,8 +280,7 @@ lspconfig.dockerfile_ls_nodejs = add_lsp {
 ---# Elixir - elixir_ls
 --- __Status__: Works
 --- __Site__: https://github.com/elixir-lsp/elixir-ls
---- __Installation__: 'paru -S elixir-ls'
---- __Note: https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=elixir-ls
+--- __Installation__: https://github.com/elixir-lsp/elixir-ls?tab=readme-ov-file#detailed-installation-instructions
 lspconfig.elixir_ls = add_lsp {
   name = "elixir_ls",
   language = "elixir",
@@ -363,14 +364,8 @@ lspconfig.gopls = add_lsp {
 ---# Groovy - groovy_ls
 --- __Status__: Untested
 --- __Site__: https://github.com/prominic/groovy-language-server
---- __Installation__:
---- ```sh
---- mkdir ~/lsp
---- cd ~/lsp
---- git clone https://github.com/prominic/groovy-language-server.git
---- cd ~/lsp/groovy-language-server
---- ./gradlew build
---- ```
+--- __Installation__: either install from your OS's package manager or build from source
+--- __Note__: how to build from source: https://github.com/GroovyLanguageServer/groovy-language-server?tab=readme-ov-file#build
 lspconfig.groovy_ls = add_lsp {
   name = "groovy_ls",
   language = "groovy",
@@ -414,6 +409,7 @@ lspconfig.vscode_html_ls = add_lsp {
 ---# Java - jdtls
 --- __Status__: Works
 --- __Site__: https://github.com/eclipse/eclipse.jdt.ls
+--- __Installation__: https://github.com/eclipse-jdtls/eclipse.jdt.ls?tab=readme-ov-file#installation
 lspconfig.jdtls = add_lsp {
   name = "jdtls",
   language = "java",
@@ -425,7 +421,7 @@ lspconfig.jdtls = add_lsp {
 ---# Javascript - flow
 --- __Status__: Untested
 --- __Site__: https://flow.org/
---- __Installation__: `npm install -g flow-bin`
+--- __Installation__: https://flow.org/en/docs/install/
 lspconfig.flow = add_lsp {
   name = "flow",
   language = "javascript",
@@ -456,7 +452,7 @@ lspconfig.quick_lint_js = add_lsp {
 ---# JSON - vscode_json_ls
 --- __Status__: Works
 --- __Site__: https://www.npmjs.com/package/vscode-json-languageserver
---- __Installation__: `npm install vscode-json-languageserver`
+--- __Installation__: https://www.npmjs.com/package/vscode-json-languageserver#integrate
 lspconfig.vscode_json_ls = add_lsp {
   name = "vscode_json_ls",
   language = "json",
@@ -475,7 +471,7 @@ lspconfig.vscode_json_ls = add_lsp {
 ---# Kotlin - kotlin_ls
 --- __Status__: Works
 --- __Site__: https://github.com/fwcd/kotlin-language-server
---- __Installation__: 'paru -S kotlin-language-server'
+--- __Installation__: https://github.com/fwcd/kotlin-language-server?tab=readme-ov-file#getting-started
 lspconfig.kotlin_ls = add_lsp {
   name = "kotlin_ls",
   language = "kotlin",
@@ -636,11 +632,7 @@ lspconfig.perlnavigator = add_lsp {
 ---# PHP - intelephense
 --- __Status__: Works
 --- __Site__: https://github.com/bmewburn/intelephense-docs
---- __Installation__: `npm -g install intelephense`
---- __Note__: Set your license and storage by passing the init_options as follows:
---- ```lua
---- init_options = { licenceKey = "...", storagePath = "/some/path"}
---- ```
+--- __Installation__: https://github.com/bmewburn/intelephense-docs/blob/master/installation.md
 lspconfig.intelephense = add_lsp {
   name = "intelephense",
   language = "php",
@@ -676,7 +668,7 @@ lspconfig.python_ls = add_lsp {
 --# Python - pyright
 --- __Status__: Works
 --- __Site__: https://github.com/microsoft/pyright
---- __Installation__: `pip install pyright`  or `npm install -g pyright`
+--- __Installation__: https://microsoft.github.io/pyright/#/installation
 lspconfig.pyright = add_lsp {
   name = "pyright",
   language = "python",
@@ -687,8 +679,8 @@ lspconfig.pyright = add_lsp {
 
 ---# R - r_ls
 -- __Status__: Works
--- __Site__:https://github.com/REditorSupport/languageserver#installation
--- __Installation__: `paru -S r-languageserver`
+-- __Site__: https://github.com/REditorSupport/languageserver
+-- __Installation__: https://github.com/REditorSupport/languageserver#installation
 lspconfig.r_ls = add_lsp {
   name = "r_ls",
   language = "r",
@@ -700,7 +692,7 @@ lspconfig.r_ls = add_lsp {
 ---# Ruby - ruby_lsp
 --- __Status__: Untested
 --- __Site__: https://github.com/Shopify/ruby-lsp
---- __Instalation__: https://github.com/Shopify/ruby-lsp?tab=readme-ov-file#getting-started
+--- __Installation__: https://github.com/Shopify/ruby-lsp?tab=readme-ov-file#getting-started
 lspconfig.ruby_lsp = add_lsp {
   name = "ruby_lsp",
   language = "ruby",
@@ -735,7 +727,7 @@ lspconfig.ruby_lsp = add_lsp {
 ---# Ruby - solargraph
 --- __Status__: Untested
 --- __Site__: https://github.com/castwide/solargraph
---- __Installation__: `gem install solargraph`
+--- __Installation__: https://github.com/castwide/solargraph?tab=readme-ov-file#installation
 lspconfig.solargraph = add_lsp {
   name = "solargraph",
   language = "ruby",
@@ -796,8 +788,7 @@ lspconfig.sql_ls = add_lsp {
 --- __Status__: Works
 --- __Site__: https://github.com/sveltejs/language-tools/tree/master/packages/language-server
 --- __Installation__: `npm install -g svelte-language-server`
---- __Note__: Also don't forget to install any additional optional dependencies
---- for additional features (see official site for details).
+--- __Note__: https://github.com/sveltejs/language-tools/tree/master/packages/language-server#how-can-i-use-it
 lspconfig.svelte_ls = add_lsp {
   name = "svelte_ls",
   language = "svelte",
@@ -809,7 +800,7 @@ lspconfig.svelte_ls = add_lsp {
 ---# Tailwind CSS - tailwind_css_ls
 --- __Status__: Broken (freezes when writing class names inside html doc, requires new implementation of json.lua)
 --- __Site__: https://github.com/tailwindlabs/tailwindcss-intellisense
---- __Installation__: Arch Linux: `sudo pacman -S tailwindcss-language-server`
+--- __Installation__: https://github.com/tailwindlabs/tailwindcss-intellisense?tab=readme-ov-file#installation
 lspconfig.tailwind_css_ls = add_lsp {
   name = "tailwind_css_ls",
   language = "html",
@@ -822,7 +813,7 @@ lspconfig.tailwind_css_ls = add_lsp {
 ---# TOML - taplo
 --- __Status__: Works
 --- __Site__: https://github.com/tamasfe/taplo
---- __Installation__: 'sudo pacman -S taplo-cli'
+--- __Installation__: https://taplo.tamasfe.dev/cli/installation/binary.html
 lspconfig.taplo = add_lsp {
   name = "taplo",
   language = "toml",
@@ -851,7 +842,7 @@ lspconfig.typescript_ls = add_lsp {
 ---# Typst - typst_lsp
 --- __Status: Works
 --- __Site__: https://github.com/nvarner/typst-lsp
---- __Instalation__: `yay typst-lsp-bin`
+--- __Installation__: https://github.com/nvarner/typst-lsp?tab=readme-ov-file#installation-guide
 lspconfig.typst_lsp = add_lsp {
   name = "typst_lsp",
   language = "typst",
@@ -915,7 +906,7 @@ lspconfig.vim_ls = add_lsp {
 ---# XML - lemminx
 --- __Status__: Works
 --- __Site__: https://github.com/eclipse/lemminx
---- __Installation__: 'paru -S lemminx'
+--- __Installation__: https://github.com/eclipse-lemminx/lemminx?tab=readme-ov-file#generating-a-native-binary
 lspconfig.lemminx = add_lsp {
   name = "lemminx",
   language = "xml",
@@ -927,7 +918,7 @@ lspconfig.lemminx = add_lsp {
 ---# YAML - yaml_ls
 --- __Status__: Untested
 --- __Site__: https://github.com/redhat-developer/yaml-language-server
---- __Installation__: 'sudo pacman -Syu yaml-language-server'
+--- __Installation__: https://github.com/redhat-developer/yaml-language-server?tab=readme-ov-file#getting-started
 lspconfig.yaml_ls = add_lsp {
   name = "yaml_ls",
   language = "yaml",

From ad564c92060efa6280206025a741f590f9e079c0 Mon Sep 17 00:00:00 2001
From: PerilousBooklet <raffaele.orabona@protonmail.com>
Date: Sat, 17 May 2025 10:11:20 +0200
Subject: [PATCH 6/7] Replaced \' with " in lsp command entries.

---
 config.lua | 46 +++++++++++++++++++++++-----------------------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/config.lua b/config.lua
index a20777d..7e2e4db 100644
--- a/config.lua
+++ b/config.lua
@@ -232,7 +232,7 @@ lspconfig.deno_ls = add_lsp {
     { id = "typescriptreact", pattern = "%.tsx$" },
   },
   file_patterns = { "%.[tj]s$", "%.[tj]sx$" },
-  command = { 'deno', 'lsp' },
+  command = { "deno", "lsp" },
   verbose = false,
   settings = {
     deno = {
@@ -309,7 +309,7 @@ lspconfig.erlang_ls = add_lsp {
   name = "erlang_ls",
   language = "erlang",
   file_patterns = { "%.erl$", "%.hrl$" },
-  command = { 'Erlang', 'LS', '-t', 'stdio' },
+  command = { "Erlang", "LS", "-t", "stdio" },
   verbose = false
 }
 
@@ -383,7 +383,7 @@ lspconfig.haskell_ls = add_lsp {
   name = "haskell_ls",
   language = "haskell",
   file_patterns = { "%.hs$", "%.lhs$" },
-  command = { 'haskell-language-server-wrapper', '--lsp' },
+  command = { "haskell-language-server-wrapper", "--lsp" },
   verbose = false
 }
 
@@ -476,7 +476,7 @@ lspconfig.kotlin_ls = add_lsp {
   name = "kotlin_ls",
   language = "kotlin",
   file_patterns = { "%.kt$", "%.kts$", "%.ktm$" },
-  command = { 'kotlin-language-server' },
+  command = { "kotlin-language-server" },
   verbose = false
 }
 
@@ -488,7 +488,7 @@ lspconfig.texlab = add_lsp {
   name = "texlab",
   language = "latex",
   file_patterns = { "%.tex$", "%.bib$" , "%.dtx$", "%.sty$", "%.ins$", "%.cls$" },
-  command = { 'texlab' }
+  command = { "texlab" }
 }
 
 ---# Lua - lua_ls
@@ -499,7 +499,7 @@ lspconfig.lua_ls = add_lsp {
   name = "lua_ls",
   language = "lua",
   file_patterns = { "%.lua$" },
-  command = { 'lua-language-server' },
+  command = { "lua-language-server" },
   verbose = false,
   settings = {
     Lua = {
@@ -649,7 +649,7 @@ lspconfig.python_ls_palantir = add_lsp {
   name = "python_ls_palantir",
   language = "python",
   file_patterns = { "%.py$" },
-  command = { 'pyls' },
+  command = { "pyls" },
   verbose = false
 }
 
@@ -661,7 +661,7 @@ lspconfig.python_ls = add_lsp {
   name = "python_ls",
   language = "python",
   file_patterns = { "%.py$" },
-  command = { 'pylsp' },
+  command = { "pylsp" },
   verbose = false
 }
 
@@ -685,7 +685,7 @@ lspconfig.r_ls = add_lsp {
   name = "r_ls",
   language = "r",
   file_patterns = { "%.r$", "%.R$" },
-  command = {'R', '--slave', '-e', 'languageserver::run()'},
+  command = {"R", "--slave", "-e", "languageserver::run()"},
   verbose = false
 }
 
@@ -697,9 +697,9 @@ lspconfig.ruby_lsp = add_lsp {
   name = "ruby_lsp",
   language = "ruby",
   file_patterns = { "%.rb$" },
-  command = { 'ruby-lsp' },
+  command = { "ruby-lsp" },
   -- Override command to one below if You want to use it with bundler
-  -- command = { 'bundle', 'exec', 'ruby-lsp'},
+  -- command = { "bundle", "exec", "ruby-lsp"},
   incremental_changes = true,
   init_options = {
     enabledFeatures = {
@@ -732,7 +732,7 @@ lspconfig.solargraph = add_lsp {
   name = "solargraph",
   language = "ruby",
   file_patterns = { "%.rb$" },
-  command = { 'solargraph', 'stdio' },
+  command = { "solargraph", "stdio" },
   verbose = false
 }
 
@@ -744,7 +744,7 @@ lspconfig.rust_ls = add_lsp {
   name = "rust_ls",
   language = "rust",
   file_patterns = { "%.rs$" },
-  command = { 'rls' },
+  command = { "rls" },
   verbose = false
 }
 
@@ -756,7 +756,7 @@ lspconfig.rust_analyzer = add_lsp {
   name = "rust_analyzer",
   language = "rust",
   file_patterns = { "%.rs$" },
-  command = { 'rust-analyzer' },
+  command = { "rust-analyzer" },
   verbose = false
 }
 
@@ -780,7 +780,7 @@ lspconfig.sql_ls = add_lsp {
   name = "sql_ls",
   language = "sql",
   file_patterns = { "%.sql$" },
-  command = { 'sql-language-server', 'up', '--method', 'stdio' },
+  command = { "sql-language-server", "up", "--method", "stdio" },
   verbose = false
 }
 
@@ -793,7 +793,7 @@ lspconfig.svelte_ls = add_lsp {
   name = "svelte_ls",
   language = "svelte",
   file_patterns = { "%.svelte$" },
-  command = { 'svelteserver', '--stdio' },
+  command = { "svelteserver", "--stdio" },
   verbose = false
 }
 
@@ -805,7 +805,7 @@ lspconfig.tailwind_css_ls = add_lsp {
   name = "tailwind_css_ls",
   language = "html",
   file_patterns = { "%.html$"},
-  command = {'tailwindcss-language-server', '--stdio'},
+  command = {"tailwindcss-language-server", "--stdio"},
   fake_snippets = true,
   verbose = false
 }
@@ -835,7 +835,7 @@ lspconfig.typescript_ls = add_lsp {
     { id = "typescriptreact", pattern = "%.tsx$"      },
   },
   file_patterns = { "%.jsx?$", "%.[cm]js$", "%.tsx?$" },
-  command = { 'typescript-language-server', '--stdio' },
+  command = { "typescript-language-server", "--stdio" },
   verbose = false
 }
 
@@ -847,7 +847,7 @@ lspconfig.typst_lsp = add_lsp {
   name = "typst_lsp",
   language = "typst",
   file_patterns = { "%.typ$" },
-  command = { 'typst-lsp' },
+  command = { "typst-lsp" },
   verbose = false,
   settings = {
     exportPdf = "never", -- Choose onType, onSave or never.
@@ -875,7 +875,7 @@ lspconfig.v_ls = add_lsp {
   name = "v_ls",
   language = "v",
   file_patterns = { "%.vv?$", "%.vsh$" },
-  command = { 'vlang-vls' },
+  command = { "vlang-vls" },
   verbose = false
 }
 
@@ -899,7 +899,7 @@ lspconfig.vim_ls = add_lsp {
   name = "vim_ls",
   language = "vim",
   file_patterns = { "%.vim$" },
-  command = { 'vim-language-server', '--stdio' },
+  command = { "vim-language-server", "--stdio" },
   verbose = false
 }
 
@@ -923,7 +923,7 @@ lspconfig.yaml_ls = add_lsp {
   name = "yaml_ls",
   language = "yaml",
   file_patterns = { "%.yml$", "%.yaml$" },
-  command = { 'yaml-language-server', '--stdio' },
+  command = { "yaml-language-server", "--stdio" },
   verbose = false
 }
 
@@ -935,7 +935,7 @@ lspconfig.zls = add_lsp {
   name = "zls",
   language = "zig",
   file_patterns = { "%.zig$" },
-  command = { 'zls' },
+  command = { "zls" },
   verbose = false
 }
 

From 37645499003e84c2da9e7fb3c6bcc3f7a61cc8c5 Mon Sep 17 00:00:00 2001
From: PerilousBooklet <raffaele.orabona@protonmail.com>
Date: Sat, 26 Jul 2025 13:57:12 +0200
Subject: [PATCH 7/7] Fixed sorting of Python entries.

---
 config.lua | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/config.lua b/config.lua
index 6a263e9..e6a02e0 100644
--- a/config.lua
+++ b/config.lua
@@ -677,31 +677,31 @@ lspconfig.python_ls = add_lsp {
   verbose = false
 }
 
---# Python - pyright
+--# Python - basedpyright
 --- __Status__: Works
---- __Site__: https://github.com/microsoft/pyright
---- __Installation__: https://microsoft.github.io/pyright/#/installation
-lspconfig.pyright = add_lsp {
-  name = "pyright",
+--- __Site__: https://github.com/DetachHead/basedpyright
+--- __Installation__: `pip install basedpyright`  or `npm install -g basedpyright`
+lspconfig.basedpyright = add_lsp {
+  name = "basedpyright",
   language = "python",
   file_patterns = { "%.py$" },
-  command = { "pyright-langserver", "--stdio" },
+  command = { "basedpyright-langserver", "--stdio" },
   verbose = false
 }
 
---# basedpyright
+--# Python - pyright
 --- __Status__: Works
---- __Site__: https://github.com/DetachHead/basedpyright
---- __Installation__: `pip install basedpyright`  or `npm install -g basedpyright`
-lspconfig.basedpyright = add_lsp {
-  name = "basedpyright",
+--- __Site__: https://github.com/microsoft/pyright
+--- __Installation__: https://microsoft.github.io/pyright/#/installation
+lspconfig.pyright = add_lsp {
+  name = "pyright",
   language = "python",
   file_patterns = { "%.py$" },
-  command = { "basedpyright-langserver", "--stdio" },
+  command = { "pyright-langserver", "--stdio" },
   verbose = false
 }
 
---# ruff
+--# Python- ruff
 --- __Status__: Works
 --- __Site__: https://github.com/astral-sh/ruff
 --- __Installation__: `pip install ruff` or `uv tool install ruff`