diff --git a/Visual-Studio-Code.md b/Visual-Studio-Code.md
index d86cbeb..5980407 100644
--- a/Visual-Studio-Code.md
+++ b/Visual-Studio-Code.md
@@ -15,10 +15,23 @@ To load vscode-ccls without installing:
 To tell the extension where to find ccls, either add ccls to your `PATH` or set "ccls.launch.command" in User Settings to the absolute path pointing to ccls.
 
 ```json
-{
-    "ccls.launch.command": "/path/to/ccls/Release/ccls",
-    "ccls.cacheDirectory": "/tmp/.ccls-cache/"
-}
+"ccls.launch.command": "/path/to/ccls/Release/ccls",
+```
+
+### `ccls.cacheDirectory`
+
+By default, ccls will store indexes in `.ccls-cache` of the workspace (more technically, the current working directory of ccls, which may not be what you think is the workspace root).
+
+You can set:
+
+```javascript
+"ccls.cacheDirectory": "${workspaceFolder}/.ccls-cache/"
+```
+
+or use a global cache directory:
+
+```javascript
+"ccls.cacheDirectory": "/tmp/ccls-cache/"
 ```
 
 ### `ccls.clang.extraArgs`