diff --git a/bin/tests/alpha/addons/main/.vscode/setting.json b/bin/tests/alpha/addons/main/.vscode/setting.json
new file mode 100644
index 00000000..e69de29b
diff --git a/bin/tests/alpha/addons/main/addon.toml b/bin/tests/alpha/addons/main/addon.toml
new file mode 100644
index 00000000..245900fb
--- /dev/null
+++ b/bin/tests/alpha/addons/main/addon.toml
@@ -0,0 +1,4 @@
+[files]
+exclude = [
+    ".vscode/*"
+]
diff --git a/book/configuration/addon.md b/book/configuration/addon.md
index 683e5fd6..f9189996 100644
--- a/book/configuration/addon.md
+++ b/book/configuration/addon.md
@@ -20,6 +20,7 @@ exclude = [
 
 [files]
 exclude = [
+    ".vscode/**/*", # Exclude all files in the .vscode folder
     "data/*.psd",
 ]
 
@@ -61,12 +62,14 @@ exclude = [
 ## files
 
 `files.exclude` is an array of glob patterns that will be excluded and not packed into the PBO.
+It is important to note that this matches against files, not folders. To exclude a folder, you must use a glob pattern that matches all files in that folder.
 
 **_/addons/banana/addon.toml_**
 
 ```toml
 [files]
 exclude = [
+    ".vscode/**/*", # Exclude all files in the .vscode folder
     "data/*.psd",
 ]
 ```