From c6a2859193c01855a3f049d48bacb04d6d9035c0 Mon Sep 17 00:00:00 2001
From: Ching Pei Yang <badnam3o.0@gmail.com>
Date: Sat, 30 Aug 2025 17:51:22 +0200
Subject: [PATCH] languages: link to vim.lsp.servers for customization

---
 modules/plugins/languages/asm.nix       | 5 ++++-
 modules/plugins/languages/astro.nix     | 5 ++++-
 modules/plugins/languages/bash.nix      | 5 ++++-
 modules/plugins/languages/clang.nix     | 5 ++++-
 modules/plugins/languages/clojure.nix   | 5 ++++-
 modules/plugins/languages/csharp.nix    | 5 ++++-
 modules/plugins/languages/css.nix       | 5 ++++-
 modules/plugins/languages/dart.nix      | 5 ++++-
 modules/plugins/languages/elixir.nix    | 5 ++++-
 modules/plugins/languages/fsharp.nix    | 5 ++++-
 modules/plugins/languages/gleam.nix     | 5 ++++-
 modules/plugins/languages/go.nix        | 5 ++++-
 modules/plugins/languages/haskell.nix   | 5 ++++-
 modules/plugins/languages/hcl.nix       | 5 ++++-
 modules/plugins/languages/helm.nix      | 5 ++++-
 modules/plugins/languages/html.nix      | 5 ++++-
 modules/plugins/languages/java.nix      | 5 ++++-
 modules/plugins/languages/json.nix      | 5 ++++-
 modules/plugins/languages/just.nix      | 5 ++++-
 modules/plugins/languages/kotlin.nix    | 5 ++++-
 modules/plugins/languages/lua.nix       | 5 ++++-
 modules/plugins/languages/markdown.nix  | 5 ++++-
 modules/plugins/languages/nim.nix       | 5 ++++-
 modules/plugins/languages/nix.nix       | 5 ++++-
 modules/plugins/languages/nu.nix        | 5 ++++-
 modules/plugins/languages/ocaml.nix     | 5 ++++-
 modules/plugins/languages/odin.nix      | 5 ++++-
 modules/plugins/languages/php.nix       | 5 ++++-
 modules/plugins/languages/python.nix    | 5 ++++-
 modules/plugins/languages/qml.nix       | 5 ++++-
 modules/plugins/languages/r.nix         | 5 ++++-
 modules/plugins/languages/ruby.nix      | 5 ++++-
 modules/plugins/languages/sql.nix       | 5 ++++-
 modules/plugins/languages/svelte.nix    | 5 ++++-
 modules/plugins/languages/tailwind.nix  | 5 ++++-
 modules/plugins/languages/terraform.nix | 5 ++++-
 modules/plugins/languages/ts.nix        | 5 ++++-
 modules/plugins/languages/typst.nix     | 5 ++++-
 modules/plugins/languages/vala.nix      | 5 ++++-
 modules/plugins/languages/wgsl.nix      | 5 ++++-
 modules/plugins/languages/yaml.nix      | 5 ++++-
 modules/plugins/languages/zig.nix       | 5 ++++-
 42 files changed, 168 insertions(+), 42 deletions(-)

diff --git a/modules/plugins/languages/asm.nix b/modules/plugins/languages/asm.nix
index 9d296755..76c7adcb 100644
--- a/modules/plugins/languages/asm.nix
+++ b/modules/plugins/languages/asm.nix
@@ -36,7 +36,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Assembly LSP server to use";
+        description = ''
+          Assembly LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/astro.nix b/modules/plugins/languages/astro.nix
index a16f286e..950f8067 100644
--- a/modules/plugins/languages/astro.nix
+++ b/modules/plugins/languages/astro.nix
@@ -91,7 +91,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Astro LSP server to use";
+        description = ''
+          Astro LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/bash.nix b/modules/plugins/languages/bash.nix
index 4597666a..91e5bf09 100644
--- a/modules/plugins/languages/bash.nix
+++ b/modules/plugins/languages/bash.nix
@@ -57,7 +57,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Bash LSP server to use";
+        description = ''
+          Bash LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/clang.nix b/modules/plugins/languages/clang.nix
index 487bc151..44346428 100644
--- a/modules/plugins/languages/clang.nix
+++ b/modules/plugins/languages/clang.nix
@@ -197,7 +197,10 @@ in {
       enable = mkEnableOption "clang LSP support" // {default = config.vim.lsp.enable;};
 
       servers = mkOption {
-        description = "The clang LSP server to use";
+        description = ''
+          The clang LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
       };
diff --git a/modules/plugins/languages/clojure.nix b/modules/plugins/languages/clojure.nix
index 442df2b7..b2d4457a 100644
--- a/modules/plugins/languages/clojure.nix
+++ b/modules/plugins/languages/clojure.nix
@@ -39,7 +39,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Clojure LSP server to use";
+        description = ''
+          Clojure LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/csharp.nix b/modules/plugins/languages/csharp.nix
index 9e13a5ef..e160f1aa 100644
--- a/modules/plugins/languages/csharp.nix
+++ b/modules/plugins/languages/csharp.nix
@@ -185,7 +185,10 @@ in {
       lsp = {
         enable = mkEnableOption "C# LSP support" // {default = config.vim.lsp.enable;};
         servers = mkOption {
-          description = "C# LSP server to use";
+          description = ''
+            C# LSP server to use. Customization of the servers can be done via
+            [](#opt-vim.lsp.servers).
+          '';
           type = singleOrListOf (enum (attrNames servers));
           default = defaultServers;
         };
diff --git a/modules/plugins/languages/css.nix b/modules/plugins/languages/css.nix
index 2d767ffc..15b03581 100644
--- a/modules/plugins/languages/css.nix
+++ b/modules/plugins/languages/css.nix
@@ -76,7 +76,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServer;
-        description = "CSS LSP server to use";
+        description = ''
+          CSS LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/dart.nix b/modules/plugins/languages/dart.nix
index 52dcd560..028f0937 100644
--- a/modules/plugins/languages/dart.nix
+++ b/modules/plugins/languages/dart.nix
@@ -54,7 +54,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Dart LSP server to use";
+        description = ''
+          Dart LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/elixir.nix b/modules/plugins/languages/elixir.nix
index 12c8a517..62982105 100644
--- a/modules/plugins/languages/elixir.nix
+++ b/modules/plugins/languages/elixir.nix
@@ -65,7 +65,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Elixir LSP server to use";
+        description = ''
+          Elixir LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/fsharp.nix b/modules/plugins/languages/fsharp.nix
index 9ead9a48..a1c48af5 100644
--- a/modules/plugins/languages/fsharp.nix
+++ b/modules/plugins/languages/fsharp.nix
@@ -74,7 +74,10 @@ in {
         servers = mkOption {
           type = singleOrListOf (enum (attrNames servers));
           default = defaultServer;
-          description = "F# LSP server to use";
+          description = ''
+            F# LSP server to use. Customization of the servers can be done via
+            [](#opt-vim.lsp.servers).
+          '';
         };
       };
       format = {
diff --git a/modules/plugins/languages/gleam.nix b/modules/plugins/languages/gleam.nix
index 984d21aa..d56804f3 100644
--- a/modules/plugins/languages/gleam.nix
+++ b/modules/plugins/languages/gleam.nix
@@ -37,7 +37,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Gleam LSP server to use";
+        description = ''
+          Gleam LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/go.nix b/modules/plugins/languages/go.nix
index 5b1aeebb..fbaa19f7 100644
--- a/modules/plugins/languages/go.nix
+++ b/modules/plugins/languages/go.nix
@@ -97,7 +97,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Go LSP server to use";
+        description = ''
+          Go LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/haskell.nix b/modules/plugins/languages/haskell.nix
index 600c7724..4c9b59b0 100644
--- a/modules/plugins/languages/haskell.nix
+++ b/modules/plugins/languages/haskell.nix
@@ -79,7 +79,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Haskell LSP server to use";
+        description = ''
+          Haskell LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/hcl.nix b/modules/plugins/languages/hcl.nix
index ca00f600..ec736f2d 100644
--- a/modules/plugins/languages/hcl.nix
+++ b/modules/plugins/languages/hcl.nix
@@ -44,7 +44,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "HCL LSP server to use";
+        description = ''
+          HCL LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/helm.nix b/modules/plugins/languages/helm.nix
index 1971eb31..bbb8e6c2 100644
--- a/modules/plugins/languages/helm.nix
+++ b/modules/plugins/languages/helm.nix
@@ -51,7 +51,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Helm LSP server to use";
+        description = ''
+          Helm LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/html.nix b/modules/plugins/languages/html.nix
index bcc6b842..ccc4e264 100644
--- a/modules/plugins/languages/html.nix
+++ b/modules/plugins/languages/html.nix
@@ -60,7 +60,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "HTML LSP server to use";
+        description = ''
+          HTML LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/java.nix b/modules/plugins/languages/java.nix
index 82fae184..c3b4e7f9 100644
--- a/modules/plugins/languages/java.nix
+++ b/modules/plugins/languages/java.nix
@@ -74,7 +74,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Java LSP server to use";
+        description = ''
+          Java LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/json.nix b/modules/plugins/languages/json.nix
index 26349710..d540610e 100644
--- a/modules/plugins/languages/json.nix
+++ b/modules/plugins/languages/json.nix
@@ -51,7 +51,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "JSON LSP server to use";
+        description = ''
+          JSON LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/just.nix b/modules/plugins/languages/just.nix
index 7645f255..04a7b8b4 100644
--- a/modules/plugins/languages/just.nix
+++ b/modules/plugins/languages/just.nix
@@ -39,7 +39,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Just LSP server to use";
+        description = ''
+          Just LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/kotlin.nix b/modules/plugins/languages/kotlin.nix
index f316c4cb..bf2be053 100644
--- a/modules/plugins/languages/kotlin.nix
+++ b/modules/plugins/languages/kotlin.nix
@@ -65,7 +65,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Kotlin LSP server to use";
+        description = ''
+          Kotlin LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/lua.nix b/modules/plugins/languages/lua.nix
index e454eaa8..67f90399 100644
--- a/modules/plugins/languages/lua.nix
+++ b/modules/plugins/languages/lua.nix
@@ -66,7 +66,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Lua LSP server to use";
+        description = ''
+          Lua LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
 
       lazydev.enable = mkEnableOption "lazydev.nvim integration, useful for neovim plugin developers";
diff --git a/modules/plugins/languages/markdown.nix b/modules/plugins/languages/markdown.nix
index 0a3f0945..5457e394 100644
--- a/modules/plugins/languages/markdown.nix
+++ b/modules/plugins/languages/markdown.nix
@@ -62,7 +62,10 @@ in {
       enable = mkEnableOption "Markdown LSP support" // {default = config.vim.lsp.enable;};
 
       servers = mkOption {
-        description = "Markdown LSP server to use";
+        description = ''
+          Markdown LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
       };
diff --git a/modules/plugins/languages/nim.nix b/modules/plugins/languages/nim.nix
index b4fab356..d6be007f 100644
--- a/modules/plugins/languages/nim.nix
+++ b/modules/plugins/languages/nim.nix
@@ -61,7 +61,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Nim LSP server to use";
+        description = ''
+          Nim LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/nix.nix b/modules/plugins/languages/nix.nix
index 6127f78e..cb6b47b2 100644
--- a/modules/plugins/languages/nix.nix
+++ b/modules/plugins/languages/nix.nix
@@ -100,7 +100,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Nix LSP server to use";
+        description = ''
+          Nix LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/nu.nix b/modules/plugins/languages/nu.nix
index d58e39a3..58e47a01 100644
--- a/modules/plugins/languages/nu.nix
+++ b/modules/plugins/languages/nu.nix
@@ -48,7 +48,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Nu LSP server to use";
+        description = ''
+          Nu LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/ocaml.nix b/modules/plugins/languages/ocaml.nix
index cf9fdd93..8dc344c0 100644
--- a/modules/plugins/languages/ocaml.nix
+++ b/modules/plugins/languages/ocaml.nix
@@ -76,7 +76,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "OCaml LSP server to use";
+        description = ''
+          OCaml LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/odin.nix b/modules/plugins/languages/odin.nix
index f18a3383..2c63476a 100644
--- a/modules/plugins/languages/odin.nix
+++ b/modules/plugins/languages/odin.nix
@@ -48,7 +48,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Odin LSP server to use";
+        description = ''
+          Odin LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/php.nix b/modules/plugins/languages/php.nix
index 353b1137..036aa907 100644
--- a/modules/plugins/languages/php.nix
+++ b/modules/plugins/languages/php.nix
@@ -79,7 +79,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "PHP LSP server to use";
+        description = ''
+          PHP LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/python.nix b/modules/plugins/languages/python.nix
index f4d749f4..768bdcaa 100644
--- a/modules/plugins/languages/python.nix
+++ b/modules/plugins/languages/python.nix
@@ -242,7 +242,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Python LSP server to use";
+        description = ''
+          Python LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/qml.nix b/modules/plugins/languages/qml.nix
index 6750a55a..fc3b2672 100644
--- a/modules/plugins/languages/qml.nix
+++ b/modules/plugins/languages/qml.nix
@@ -48,7 +48,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "QML LSP server to use";
+        description = ''
+          QML LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/r.nix b/modules/plugins/languages/r.nix
index 873edaa3..2d7ecab2 100644
--- a/modules/plugins/languages/r.nix
+++ b/modules/plugins/languages/r.nix
@@ -79,7 +79,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "R LSP server to use";
+        description = ''
+          R LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/ruby.nix b/modules/plugins/languages/ruby.nix
index 94e27277..b0aece71 100644
--- a/modules/plugins/languages/ruby.nix
+++ b/modules/plugins/languages/ruby.nix
@@ -79,7 +79,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Ruby LSP server to use";
+        description = ''
+          Ruby LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/sql.nix b/modules/plugins/languages/sql.nix
index c1ea6678..9c919de9 100644
--- a/modules/plugins/languages/sql.nix
+++ b/modules/plugins/languages/sql.nix
@@ -80,7 +80,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "SQL LSP server to use";
+        description = ''
+          SQL LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/svelte.nix b/modules/plugins/languages/svelte.nix
index 301a51d7..a28d6dcf 100644
--- a/modules/plugins/languages/svelte.nix
+++ b/modules/plugins/languages/svelte.nix
@@ -101,7 +101,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Svelte LSP server to use";
+        description = ''
+          Svelte LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/tailwind.nix b/modules/plugins/languages/tailwind.nix
index 4e63a8d8..1ce452d2 100644
--- a/modules/plugins/languages/tailwind.nix
+++ b/modules/plugins/languages/tailwind.nix
@@ -156,7 +156,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Tailwindcss LSP server to use";
+        description = ''
+          Tailwindcss LSP server to use. Customization of the servers can be
+          done via [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/terraform.nix b/modules/plugins/languages/terraform.nix
index 5f3952df..85301a71 100644
--- a/modules/plugins/languages/terraform.nix
+++ b/modules/plugins/languages/terraform.nix
@@ -38,7 +38,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Terraform LSP server to use";
+        description = ''
+          Terraform LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/ts.nix b/modules/plugins/languages/ts.nix
index 40e598ae..d1c36848 100644
--- a/modules/plugins/languages/ts.nix
+++ b/modules/plugins/languages/ts.nix
@@ -230,7 +230,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Typescript/Javascript LSP server to use";
+        description = ''
+          Typescript/Javascript LSP server to use. Customization of the servers
+          can be done via [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/typst.nix b/modules/plugins/languages/typst.nix
index fbeb0ce2..cf6b2d75 100644
--- a/modules/plugins/languages/typst.nix
+++ b/modules/plugins/languages/typst.nix
@@ -116,7 +116,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Typst LSP server to use";
+        description = ''
+          Typst LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/vala.nix b/modules/plugins/languages/vala.nix
index 722b0d3b..154b6276 100644
--- a/modules/plugins/languages/vala.nix
+++ b/modules/plugins/languages/vala.nix
@@ -75,7 +75,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Vala LSP server to use";
+        description = ''
+          Vala LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/wgsl.nix b/modules/plugins/languages/wgsl.nix
index 8c33e581..a8965432 100644
--- a/modules/plugins/languages/wgsl.nix
+++ b/modules/plugins/languages/wgsl.nix
@@ -39,7 +39,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "WGSL LSP server to use";
+        description = ''
+          WGSL LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/yaml.nix b/modules/plugins/languages/yaml.nix
index 1869b1c1..1b44eb45 100644
--- a/modules/plugins/languages/yaml.nix
+++ b/modules/plugins/languages/yaml.nix
@@ -58,7 +58,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Yaml LSP server to use";
+        description = ''
+          Yaml LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/zig.nix b/modules/plugins/languages/zig.nix
index 966e9369..6ab3ce5a 100644
--- a/modules/plugins/languages/zig.nix
+++ b/modules/plugins/languages/zig.nix
@@ -69,7 +69,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Zig LSP server to use";
+        description = ''
+          Zig LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };