From 396a54da5da1f6cdc128989c81d0091de46a9a9b Mon Sep 17 00:00:00 2001 From: Mohamed Shams El-Deen Date: Thu, 2 Jul 2026 08:00:57 +0300 Subject: [PATCH 1/5] 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 dc92296bfcd68a01499a9ed7b9d99163a314acd6 Mon Sep 17 00:00:00 2001 From: Mohamed Shams El-Deen Date: Thu, 2 Jul 2026 22:33:56 +0300 Subject: [PATCH 2/5] 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 b6f476adbaab79b68e6e564ffd84204b5cb94647 Mon Sep 17 00:00:00 2001 From: Mohamed Shams El-Deen Date: Thu, 2 Jul 2026 22:43:37 +0300 Subject: [PATCH 3/5] 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)$/, ''), + })), + ], }, ], }; From 70d0571c42e4c4cd02dbe1406078a7e0074b169f Mon Sep 17 00:00:00 2001 From: Mohamed Shams El-Deen Date: Sat, 4 Jul 2026 18:00:08 +0300 Subject: [PATCH 4/5] chore: put loaders & plugins in main packages section and summarize the docs/index.md --- pages/docs/index.md | 22 +++------------------- pages/site.mjs | 6 ++---- 2 files changed, 5 insertions(+), 23 deletions(-) diff --git a/pages/docs/index.md b/pages/docs/index.md index 295cca1e..2a986d61 100644 --- a/pages/docs/index.md +++ b/pages/docs/index.md @@ -6,22 +6,6 @@ authors: moshams272 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) - -#### 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) +- [Webpack](/docs/api/v5.x) — Explore the webpack's core configuration, CLI commands, and APIs. +- [Loaders](/docs/loaders) — Discover third-party loaders to process CSS, TypeScript, images, and other file types. +- [Plugins](/docs/plugins) — Browse community plugins to extend webpack for build optimization, asset management, and more. diff --git a/pages/site.mjs b/pages/site.mjs index 96ae2b3a..1becb6c0 100644 --- a/pages/site.mjs +++ b/pages/site.mjs @@ -33,12 +33,10 @@ export const sidebar = { link: `/docs/api/v${major(v)}.x`, })), }, + ...loaders.sidebar, + ...plugins.sidebar, ], }, - { - groupName: 'Third Party Packages', - items: [...loaders.sidebar, ...plugins.sidebar], - }, ], guides: guides.sidebar, }; From 3412fc1d720d7e864e43fd2062c712a1198867b4 Mon Sep 17 00:00:00 2001 From: Mohamed Shams El-Deen <68347231+moshams272@users.noreply.github.com> Date: Sat, 4 Jul 2026 20:55:54 +0300 Subject: [PATCH 5/5] Update pages/docs/index.md Co-authored-by: Aviv Keller --- pages/docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/docs/index.md b/pages/docs/index.md index 2a986d61..bebadcc1 100644 --- a/pages/docs/index.md +++ b/pages/docs/index.md @@ -4,7 +4,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. +These pages provide technical details on webpack's API. - [Webpack](/docs/api/v5.x) — Explore the webpack's core configuration, CLI commands, and APIs. - [Loaders](/docs/loaders) — Discover third-party loaders to process CSS, TypeScript, images, and other file types.