From 71f68eeb7aa47a12427eb7cb7575ccb78de0613d Mon Sep 17 00:00:00 2001
From: Mohamed Shams El-Deen <mohamedshamseldeen95@gmail.com>
Date: Thu, 2 Jul 2026 08:00:57 +0300
Subject: [PATCH 1/3] feat(docs): restructure sidebar dropdowns and replace
 /docs STUB

---
 pages/docs/index.md          | 22 +++++++++++++++++++++-
 pages/site.mjs               |  6 ++++--
 scripts/markdown/readmes.mjs |  2 +-
 3 files changed, 26 insertions(+), 4 deletions(-)

diff --git a/pages/docs/index.md b/pages/docs/index.md
index 5568faad..19d37bb6 100644
--- a/pages/docs/index.md
+++ b/pages/docs/index.md
@@ -1,3 +1,23 @@
 # Documentation
 
-STUB
+The documentation provides deep technical details on webpack's API, configuration, and ecosystem. Whether you are looking up core features or exploring community tools, you will find everything you need below.
+
+### Main Packages
+
+Explore the core configuration, CLI commands, and Node.js API for the latest version of webpack. This is your definitive reference for webpack's built-in capabilities.
+
+[Explore the webpack API!](/docs/api/v5.x)
+
+### Third Party Packages
+
+#### Loaders
+
+Loaders allow webpack to process other types of files and convert them into valid modules. Discover the extensive ecosystem of third-party loaders for CSS, TypeScript, images, and more.
+
+[Discover community loaders!](/docs/loaders/coffee-loader)
+
+#### Plugins
+
+Plugins are the backbone of webpack's architecture. Browse community-maintained plugins that extend webpack's capabilities for build optimization, asset management, and environment injection.
+
+[Browse community plugins!](/docs/plugins/compression-webpack-plugin)
diff --git a/pages/site.mjs b/pages/site.mjs
index 605276a9..96ae2b3a 100644
--- a/pages/site.mjs
+++ b/pages/site.mjs
@@ -35,8 +35,10 @@ export const sidebar = {
         },
       ],
     },
-    ...loaders.sidebar,
-    ...plugins.sidebar,
+    {
+      groupName: 'Third Party Packages',
+      items: [...loaders.sidebar, ...plugins.sidebar],
+    },
   ],
   guides: guides.sidebar,
 };
diff --git a/scripts/markdown/readmes.mjs b/scripts/markdown/readmes.mjs
index b374989e..12abb3c0 100644
--- a/scripts/markdown/readmes.mjs
+++ b/scripts/markdown/readmes.mjs
@@ -70,7 +70,7 @@ const processRepos = async (repos, { label, basePath, outputDir }) => {
   const siteJson = {
     sidebar: [
       {
-        groupName: label,
+        label: label,
         items: fetched.map(name => ({
           link: `${basePath}/${name}`,
           label: name.replace(/-(?:webpack-)?(?:loader|plugin)$/, ''),

From 6673188798c6f1dd6c76210d9dbda30c06bd51e3 Mon Sep 17 00:00:00 2001
From: Mohamed Shams El-Deen <mohamedshamseldeen95@gmail.com>
Date: Thu, 2 Jul 2026 22:33:56 +0300
Subject: [PATCH 2/3] fix: route the links to indexs pages

---
 pages/docs/index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pages/docs/index.md b/pages/docs/index.md
index 19d37bb6..19a0a61f 100644
--- a/pages/docs/index.md
+++ b/pages/docs/index.md
@@ -14,10 +14,10 @@ Explore the core configuration, CLI commands, and Node.js API for the latest ver
 
 Loaders allow webpack to process other types of files and convert them into valid modules. Discover the extensive ecosystem of third-party loaders for CSS, TypeScript, images, and more.
 
-[Discover community loaders!](/docs/loaders/coffee-loader)
+[Discover community loaders!](/docs/loaders)
 
 #### Plugins
 
 Plugins are the backbone of webpack's architecture. Browse community-maintained plugins that extend webpack's capabilities for build optimization, asset management, and environment injection.
 
-[Browse community plugins!](/docs/plugins/compression-webpack-plugin)
+[Browse community plugins!](/docs/plugins)

From 85a3b65a56ca974679431a2ac8d1d278196b4fa6 Mon Sep 17 00:00:00 2001
From: Mohamed Shams El-Deen <mohamedshamseldeen95@gmail.com>
Date: Thu, 2 Jul 2026 22:43:37 +0300
Subject: [PATCH 3/3] fix: add Overview in site.json

---
 pages/docs/index.md          |  4 ++++
 scripts/markdown/readmes.mjs | 14 ++++++++++----
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/pages/docs/index.md b/pages/docs/index.md
index 19a0a61f..295cca1e 100644
--- a/pages/docs/index.md
+++ b/pages/docs/index.md
@@ -1,3 +1,7 @@
+---
+authors: moshams272
+---
+
 # Documentation
 
 The documentation provides deep technical details on webpack's API, configuration, and ecosystem. Whether you are looking up core features or exploring community tools, you will find everything you need below.
diff --git a/scripts/markdown/readmes.mjs b/scripts/markdown/readmes.mjs
index 12abb3c0..8a29aebf 100644
--- a/scripts/markdown/readmes.mjs
+++ b/scripts/markdown/readmes.mjs
@@ -71,10 +71,16 @@ const processRepos = async (repos, { label, basePath, outputDir }) => {
     sidebar: [
       {
         label: label,
-        items: fetched.map(name => ({
-          link: `${basePath}/${name}`,
-          label: name.replace(/-(?:webpack-)?(?:loader|plugin)$/, ''),
-        })),
+        items: [
+          {
+            link: basePath,
+            label: 'Overview',
+          },
+          ...fetched.map(name => ({
+            link: `${basePath}/${name}`,
+            label: name.replace(/-(?:webpack-)?(?:loader|plugin)$/, ''),
+          })),
+        ],
       },
     ],
   };