diff --git a/docs/index.md b/docs/index.md
index e4736e7b51..7b8360a7fd 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -141,7 +141,7 @@ developer/plugins
 :maxdepth: 1
 troubleshooting/cache-failures.md
 troubleshooting/compute-storage.md
-troubleshooting/vscode.md
+troubleshooting/language-server.md
 ```
 
 ```{toctree}
diff --git a/docs/troubleshooting/compute-storage.md b/docs/troubleshooting/compute-storage.md
index 505c9bcbcc..31910c5eea 100644
--- a/docs/troubleshooting/compute-storage.md
+++ b/docs/troubleshooting/compute-storage.md
@@ -1,5 +1,7 @@
 # Compute and storage
 
+This page describes common compute and storage errors and strategies to resolve them.
+
 ## Amazon Web Services
 
 ### Job queue not found
diff --git a/docs/troubleshooting/vscode.md b/docs/troubleshooting/language-server.md
similarity index 95%
rename from docs/troubleshooting/vscode.md
rename to docs/troubleshooting/language-server.md
index e0b0e471b2..7329250bb7 100644
--- a/docs/troubleshooting/vscode.md
+++ b/docs/troubleshooting/language-server.md
@@ -1,6 +1,6 @@
 # Language server
 
-This page describes common errors and strategies strategies to resolve language server error.
+This page describes common language server errors and strategies to resolve them.
 
 ## Common errors