chore: remove docs hubs, add redirects (#856)

Author: yslpn

config/docusaurus/footer.js

@@ -15,7 +15,7 @@ const footer = {
         {
             title: "Specs",
             items: [
-                { label: "Documentation", to: "/docs" },
+                { label: "Documentation", to: "/docs/get-started/overview" },
                 { label: "Community", to: "/community" },
                 { label: "Help", to: "/nav" },
                 { label: "Discussions", href: `${GITHUB_DOCS}/discussions` },

config/docusaurus/navbar.js

@@ -12,7 +12,8 @@ const navbar = {
         // left
         {
             label: "📖 Docs",
-            to: "/docs",
+            to: "/docs/get-started/overview",
+            activeBaseRegex: "/docs(/.*)?$",
             position: "left",
         },
         {

config/docusaurus/routes.js

@@ -124,17 +124,17 @@ const LEGACY_ROUTES = [
             {
                 title: "App splitting",
                 from: "/docs/concepts/app-splitting",
-                to: "/docs/reference",
+                to: "/docs/reference/layers",
             },
             {
                 title: "Decomposition",
                 from: "/docs/reference/units/decomposition",
-                to: "/docs/reference",
+                to: "/docs/reference/layers",
             },
             {
                 title: "Units",
                 from: "/docs/reference/units",
-                to: "/docs/reference",
+                to: "/docs/reference/layers",
             },
             {
                 title: "Layers",
@@ -305,10 +305,19 @@ const SECTIONS_REDIRECTS = Object.values(SECTIONS).map(
     }),
 );
 
+// Redirects for removed hub/landing pages
+const HUB_REDIRECTS = [
+    { from: "/docs", to: "/docs/get-started/overview" },
+    { from: "/docs/get-started", to: "/docs/get-started/overview" },
+    { from: "/docs/guides", to: "/docs/guides/examples/auth" },
+    { from: "/docs/guides/examples", to: "/docs/guides/examples/auth" },
+    { from: "/docs/reference", to: "/docs/reference/layers" },
+    { from: "/docs/about", to: "/docs/about/mission" },
+];
+
 // !!! FIXME: refactor later!
 // UPD: Removed new docs routes for simplifying
 const _TOTAL_ROUTES = [
-    "/docs/about",
     "/docs/about/alternatives",
     "/docs/about/mission",
     "/docs/about/motivation",
@@ -317,13 +326,10 @@ const _TOTAL_ROUTES = [
     "/docs/about/promote/integration",
     "/docs/about/promote/partial-application",
     "/docs/branding",
-    "/docs/get-started",
     "/docs/get-started/overview",
     "/docs/get-started/cheatsheet",
     "/docs/get-started/faq",
     "/docs/get-started/tutorial",
-    "/docs/guides",
-    "/docs/guides/examples",
     "/docs/guides/examples/auth",
     "/docs/guides/examples/autocompleted",
     "/docs/guides/examples/browser-api",
@@ -341,8 +347,6 @@ const _TOTAL_ROUTES = [
     "/docs/guides/migration/from-custom",
     "/docs/guides/migration/from-v1",
     "/docs/guides/tech/with-nextjs",
-    "/docs/",
-    "/docs/reference",
 ];
 // from: "/en/docs/*" to "/docs/*"
 const I18N_REDIRECTS = _TOTAL_ROUTES.map((route) => ({
@@ -355,6 +359,7 @@ const REDIRECTS = [
     ...SECTIONS_REDIRECTS,
     ...LEGACY_ROUTES_REDIRECTS,
     ...I18N_REDIRECTS,
+    ...HUB_REDIRECTS,
 ];
 
 module.exports = {

config/docusaurus/sidebars.docs.js

@@ -25,7 +25,6 @@ const getSidebar = (category) => [
     {
         type: "category",
         label: CATEGORIES[category],
-        link: { type: "doc", id: `${category}/index` },
         items: [{ type: "autogenerated", dirName: category }],
         collapsible: false,
     },

i18n/en/docusaurus-plugin-content-docs/current/about/index.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_position: 20
-pagination_next: guides/index
+pagination_next: guides/examples/auth
 ---
 
 # FAQ

i18n/en/docusaurus-plugin-content-docs/current/get-started/faq.md

@@ -1,7 +1,7 @@
 ---
 sidebar_position: 4
 sidebar_class_name: sidebar-item--wip
-pagination_next: reference/index
+pagination_next: reference/layers
 ---
 
 import WIP from '@site/src/shared/ui/wip/tmpl.mdx'