feat: restructure docs navigation (#2045)

* feat: new horizontal nav (#2018)

* feat: new docs nav

* fix: add start page to navbar

* fix: add homepages to horizontal nav items

* feat: vertical nav (#2020)

* feat: vertical nav for quickstart

* feat: vertical nav for identity

* chore: credentials structure

* chore: update identity sidebar structure for session management and identity actions

* feat: restructure OAuth2 sidebar for improved navigation and updated links

* feat: enhance permissions sidebar structure

* feat: update navigation links for OAuth2 and Permissions documentation

* chore: deprioritize selfhosting sidebar

* chore: feedback updates or restructure

* fix: remove home link from home page

* fix: Make oauth2 actions apparent

* feat: dropdown menus in horizontal nav (#2042)

* feat: horizontal dropdown nav

* feat: horizontal dropdown nav

* chore: use Ory official product names

* chore: relocate operations docs from API to Platform

* chore: remove old sidebar (#2044)

* chore: remove old sidebar

* chore: remove home link from start sidebar

* fix: redirects and broken links

Author: christiannwamba

docs/guides/authentication.mdx

@@ -6,7 +6,7 @@ import type * as Preset from "@docusaurus/preset-classic"
 
 import lightTheme from "./src/utils/prismLight.mjs"
 import darkTheme from "./src/utils/prismDark.mjs"
-
+import { navbar } from "./src/navbar"
 const config: Config = {
   customFields: {
     CLOUD_URL: process.env.CLOUD_URL || "https://api.console.ory:8080",
@@ -86,85 +86,7 @@ const config: Config = {
       indexName: "ory",
       contextualSearch: true,
     },
-    navbar: {
-      hideOnScroll: false,
-      logo: {
-        alt: "Ory",
-        src: `/docs/img/logos/logo-docs-2023-02-15.svg`,
-        srcDark: `/docs/img/logos/logo-docs-dark-2023-02-15.svg`,
-        href: `https://www.ory.sh`,
-        width: 63,
-        height: 32,
-      },
-      items: [
-        {
-          type: "docSidebar",
-          position: "left",
-          sidebarId: "docs",
-          label: "Documentation",
-        },
-        {
-          type: "docSidebar",
-          position: "left",
-          sidebarId: "quickstarts-and-tutorials",
-          label: "Quickstart",
-        },
-        {
-          type: "docSidebar",
-          position: "left",
-          sidebarId: "guides",
-          label: "Guides",
-        },
-        {
-          type: "docSidebar",
-          position: "left",
-          sidebarId: "reference",
-          label: "Reference",
-        },
-        {
-          type: "docSidebar",
-          position: "left",
-          sidebarId: "selfhosting",
-          label: "Self-hosting",
-        },
-        {
-          label: "Need Support?",
-          position: "right",
-          items: [
-            {
-              to: "https://www.ory.sh/support",
-              label: "Enterprise Support",
-            },
-            {
-              to: "https://www.ory.sh/docs/search",
-              label: "Search the docs",
-            },
-            {
-              to: "https://www.ory.sh/chat",
-              label: "Ory Community Slack",
-            },
-            {
-              to: "https://github.com/orgs/ory/discussions",
-              label: "GitHub Discussions",
-            },
-            {
-              to: "https://stackoverflow.com/questions/tagged/ory",
-              label: "Stack Overflow",
-            },
-            {
-              to: "https://www.ory.sh/contact",
-              label: "Schedule a discovery call",
-            },
-          ],
-        },
-
-        {
-          href: `https://github.com/ory`,
-          label: "GitHub",
-          position: "right",
-        },
-      ],
-    },
+    navbar,
     footer: {
       style: "dark",
       copyright: `Copyright © ${new Date().getFullYear()} Ory Corp`,
@@ -243,10 +165,10 @@ const config: Config = {
       "@docusaurus/plugin-client-redirects",
       {
         redirects: [
-          // {
-          // from: ['/','/docs','/docs/'],
-          // to: '/docs/welcome'
-          // }
+          {
+            from: "/quickstart/sdks",
+            to: "/sdk",
+          },
         ],
       },
     ],

docs/quickstart/sdks.mdx

@@ -0,0 +1,124 @@
+import { Navbar } from "@docusaurus/theme-common"
+
+export const navbar: Navbar = {
+  hideOnScroll: false,
+  logo: {
+    alt: "Ory",
+    src: `/docs/img/logos/logo-docs-2023-02-15.svg`,
+    srcDark: `/docs/img/logos/logo-docs-dark-2023-02-15.svg`,
+    href: `https://www.ory.sh`,
+    width: 63,
+    height: 32,
+  },
+  items: [
+    {
+      to: "/getting-started/overview",
+      label: "Start",
+      position: "left",
+    },
+    {
+      label: "Products",
+      position: "left",
+      items: [
+        {
+          to: "/docs/identities",
+          label: "Identities",
+        },
+        {
+          to: "/docs/getting-started/ory-network-oauth2",
+          //   to: "/docs/federation", // TODO: Use this route
+          label: "OAuth2/OIDC",
+        },
+        {
+          to: "/docs/guides/permissions/overview",
+          //   to: "/docs/permissions", // TODO: Use this route
+          label: "Permissions",
+        },
+      ],
+    },
+    {
+      label: "Develop",
+      position: "left",
+      items: [
+        {
+          to: "/docs/getting-started/local-development",
+          label: "Local Development",
+        },
+        {
+          to: "/docs/ecosystem/projects",
+          label: "Self-Hosting",
+        },
+      ],
+    },
+    {
+      label: "Manage",
+      position: "left",
+      items: [
+        {
+          to: "/docs/guides/operations",
+          label: "Platform",
+        },
+        {
+          to: "/docs/category/troubleshooting",
+          label: "Troubleshooting",
+        },
+      ],
+    },
+    {
+      //   to: "/docs/reference/api",
+      //   to: "/docs/reference", // TODO: Use this route
+      label: "Reference",
+      position: "left",
+      items: [
+        {
+          to: "/docs/reference/api",
+          label: "REST API",
+        },
+        {
+          to: "/docs/category/ory-cli-reference",
+          label: "Ory CLI",
+        },
+        {
+          to: "/docs/sdk",
+          label: "Ory SDKs",
+        },
+      ],
+    },
+    {
+      label: "Need Support?",
+      position: "right",
+      items: [
+        {
+          to: "https://www.ory.sh/support",
+          label: "Enterprise Support",
+        },
+        {
+          to: "https://www.ory.sh/docs/search",
+          label: "Search the docs",
+        },
+        {
+          to: "https://www.ory.sh/chat",
+          label: "Ory Community Slack",
+        },
+        {
+          to: "https://github.com/orgs/ory/discussions",
+          label: "GitHub Discussions",
+        },
+        {
+          to: "https://stackoverflow.com/questions/tagged/ory",
+          label: "Stack Overflow",
+        },
+        {
+          to: "https://www.ory.sh/contact",
+          label: "Schedule a discovery call",
+        },
+      ],
+    },
+
+    {
+      href: `https://github.com/ory`,
+      label: "GitHub",
+      position: "right",
+    },
+  ],
+}