diff --git a/Documentation/CLionConfiguration.md b/Documentation/CLionConfiguration.md
index 2fb953b93b3..8e723aca1a2 100644
--- a/Documentation/CLionConfiguration.md
+++ b/Documentation/CLionConfiguration.md
@@ -39,6 +39,13 @@ want exclude Toolchain files as well, follow the same procedure with the followi
 - `Toolchain/Tarballs`
 - `Toolchain/Build`
 
+## Include headers and source files for code insight
+
+To get proper code insight mark the folders `AK`, `Kernel` and `Userland` by right-clicking on them and selecting `Mark Directory as | Project Sources and Headers`.
+
+A symptom of this not being configured correctly is CLion giving a warning for every single file: 
+> The file does not belong to any project target, code insight features might not work properly.
+
 ## Code Generation Settings
 
 To make code generated by CLion (e.g. identifier names, const placement) match the SerenityOS coding style, change the