From b28d6b06affa328a64c79b86930b366d9f0c1738 Mon Sep 17 00:00:00 2001
From: Anoms12 <117039159+Anoms12@users.noreply.github.com>
Date: Tue, 5 Aug 2025 17:31:51 -0400
Subject: [PATCH 1/2] feat: add folders docs  layout and placeholder info

---
 content/docs/user-manual/folders.mdx | 30 ++++++++++++++++++++++++++++
 content/docs/user-manual/index.mdx   |  5 +++++
 2 files changed, 35 insertions(+)
 create mode 100644 content/docs/user-manual/folders.mdx

diff --git a/content/docs/user-manual/folders.mdx b/content/docs/user-manual/folders.mdx
new file mode 100644
index 0000000..3695c18
--- /dev/null
+++ b/content/docs/user-manual/folders.mdx
@@ -0,0 +1,30 @@
+---
+title: Folders
+description: Organize your tabs with folders
+---
+
+# Folders
+
+Folders let you organize your tabs into manageable groups, helping you keep your workspace clean and focused.
+
+## Creating a Folder
+
+You can create a folder in two ways:
+
+1. **From a Tab**  
+   Right-click on any tab and select **"Add to folder"** to group it into a new or existing folder.
+
+2. **From the Toolbar**  
+   Right-click on any empty space in the toolbar and choose **"New folder"**.
+
+## Using Folders
+
+- All folders appear in the **pinned tabs container**.
+- You can **drag tabs** into a folder.
+- You can **drag folders around** to rearrange them.
+- You can also **drag folders into other folders** to create _nested folders_ (also called subfolders).
+
+<Callout>
+Nested folders are a great way to organize related projects or workflows with multiple levels of detail.
+</Callout>
+
diff --git a/content/docs/user-manual/index.mdx b/content/docs/user-manual/index.mdx
index fc7fa16..3f7060d 100644
--- a/content/docs/user-manual/index.mdx
+++ b/content/docs/user-manual/index.mdx
@@ -35,6 +35,11 @@ Welcome to the Zen Browser User Manual! This guide is designed to provide you wi
     description="Customize Zen Browser with extensions"
     href="/user-manual/extensions"
   />
+  <Card
+    title="Folders"
+    description="Organize your tabs with folders"
+    href="/user-manual/folders"
+  />
   <Card 
     title="Glance" 
     description="Preview websites on top of your current tab" 

From 423b60c8c91892ac884c0e80db27ca7581ca61a0 Mon Sep 17 00:00:00 2001
From: Anoms12 <117039159+Anoms12@users.noreply.github.com>
Date: Tue, 5 Aug 2025 18:02:28 -0400
Subject: [PATCH 2/2] feat: Better Structure

---
 content/docs/user-manual/folders.mdx | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/content/docs/user-manual/folders.mdx b/content/docs/user-manual/folders.mdx
index 3695c18..07527c5 100644
--- a/content/docs/user-manual/folders.mdx
+++ b/content/docs/user-manual/folders.mdx
@@ -22,9 +22,20 @@ You can create a folder in two ways:
 - All folders appear in the **pinned tabs container**.
 - You can **drag tabs** into a folder.
 - You can **drag folders around** to rearrange them.
-- You can also **drag folders into other folders** to create _nested folders_ (also called subfolders).
+- You can also **drag folders into other folders** to create nested folders.
+
+## Features
+
+### Nested folders
 
-<Callout>
 Nested folders are a great way to organize related projects or workflows with multiple levels of detail.
-</Callout>
+For example, you can create a folder for your work, and then create a folder for each project you're working on. 
+This has far many more use cases, feel free to explore and experiment with it.
+
+### Search Menu
+
+The search menu is a great way to find tabs in your folders.
+
+### Icon Picker
 
+The icon picker is a great way to change the icon of a folder.