diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 00000000..5c639da2
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,3 @@
+{
+  "files.trimTrailingWhitespace": false
+}
diff --git a/packages/docs/src/docs/docs/editor-plugins.mdx b/packages/docs/src/docs/docs/editor-plugins.mdx
index 249bb2ad..5c19d134 100644
--- a/packages/docs/src/docs/docs/editor-plugins.mdx
+++ b/packages/docs/src/docs/docs/editor-plugins.mdx
@@ -26,7 +26,9 @@ To run the extension in debug mode you need to:
 $ git clone https://github.com/JSMonk/hegel
 ```
 
-2. Open `hegel/packages/language-server` in Visual Studio Code
+2. Add `hegel/packages/language-server` to your VS code workspace. Do not
+open `hegel` or add `hegel` to your workspace, otherwise "Run and Debug" cannot
+find the `.vscode/launch.json` configuration.
 
 3. Go to the "Run and Debug" section