From 0da5fe781ae9785fa65ae32b93a4ca88b5f16abf Mon Sep 17 00:00:00 2001
From: outfoxxed <outfoxxed@outfoxxed.me>
Date: Sat, 5 Jul 2025 02:27:45 -0700
Subject: [PATCH] note root:/ paths break lsp and singletons

---
 src/guide/introduction.mdx | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/guide/introduction.mdx b/src/guide/introduction.mdx
index 924da80..305e76c 100644
--- a/src/guide/introduction.mdx
+++ b/src/guide/introduction.mdx
@@ -24,6 +24,13 @@ A specific configuration can be picked using the `--config` or `-c` argument to
 Configs located at other paths outside XDG standard, including raw qml files,
 can be run with `--path` or `-p`.
 
+> [!CAUTION]
+> Many users use root imports, in the form `import "root:/path/to/module"`. These are an old
+> Quickshell feature that will break the LSP and singletons. Keep that in mind if you decide
+> to use them.
+>
+> A replacement without these issues is planned.
+
 ## Creating Windows
 
 Quickshell has two main window types available: