refactor: docs url structure

docs/docs/about/about.md

@@ -1,10 +0,0 @@
----
-title: About Jan
-slug: /about
----
-
-## Problem
-
-## Ideal Customer Persona
-
-## Business Model

docs/docs/about/brand-assets.md

@@ -1,3 +0,0 @@
----
-title: Brand Assets
----

docs/docs/about/team.md

@@ -1,4 +0,0 @@
----
-title: Team
----
-

docs/docs/changelog/README.md

@@ -1,6 +0,0 @@
----
-sidebar_position: 1
-title: Changelog
----
-
-TODO

docs/docs/docs/docs.md

@@ -1,6 +0,0 @@
----
-sidebar_position: 1
-title: Getting Started
----
-
-TODO

docs/docs/overview/app_anatomy.md

@@ -1,16 +1,17 @@
 ---
-sidebar_position: 1
+sidebar_position: 3
 title: App Anatomy
 ---
 
 Platform has 3 events that are broadcast to installed Apps
 ![Platform events](img/app-anatomy-4.drawio.png)
+
 - onLaunch()
-![Platform onLaunch()](img/app-anatomy-1.drawio.png)
+  ![Platform onLaunch()](img/app-anatomy-1.drawio.png)
 - onStart()
-![Platform onStart()](img/app-anatomy-2.drawio.png)
+  ![Platform onStart()](img/app-anatomy-2.drawio.png)
 - onDispose()
-![Platform onDispose()](img/app-anatomy-3.drawio.png)
+  ![Platform onDispose()](img/app-anatomy-3.drawio.png)
 - At any given time, when there is new App installtion/ unintallation, the Platform restarts and trigger
 - When App is being used, here is how the information passes between Platform and Apps
-![Communication](img/app-anatomy-5.drawio.png)
+  ![Communication](img/app-anatomy-5.drawio.png)

docs/docs/overview/concepts.md

@@ -1,11 +1,12 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
 title: Concepts
 ---
 
 ## Concepts
+
 - Jan Platform: Desktop app/ Cloud native SaaS that can run on Linux, Windows, Mac or even Server that comes with extensibilities, toolbox and state of the art but optimized models for next gen App.
 - Jan App: Next gen App built on Jan Plaform as `portable intelligence` that can be run everywhere.
 - Models:
   - LLM models
-  - Other models
+  - Other models

docs/docs/platform/platform.md

@@ -1,5 +0,0 @@
----
-sidebar_position: 1
-title: Overview
-slug: /platform
----

docs/docs/products/desktop.md

@@ -1,3 +0,0 @@
----
-title: Jan Desktop
----

docs/docs/products/mobile.md

@@ -1,3 +0,0 @@
----
-title: Jan Mobile
----

docs/docs/products/products.md

@@ -1,4 +0,0 @@
----
-title: Products
-slug: /product
----

docs/docs/products/server.md

@@ -1,3 +0,0 @@
----
-title: Jan Server
----

docs/docs/solutions/industries/education.md

@@ -1,3 +0,0 @@
----
-title: Education
----

docs/docs/solutions/industries/finance.md

@@ -1,3 +0,0 @@
----
-title: Finance
----

docs/docs/solutions/industries/healthcare.md

@@ -1,3 +0,0 @@
----
-title: Healthcare
----

docs/docs/solutions/industries/law.md

@@ -1,3 +0,0 @@
----
-title: Law
----

docs/docs/solutions/industries/public-sector.md

@@ -1,3 +0,0 @@
----
-title: Public Sector
----

docs/docs/solutions/industries/software.md

@@ -1,3 +0,0 @@
----
-title: Software Engineering
----

docs/docs/solutions/personal-ai.md

@@ -1,3 +0,0 @@
----
-title: Personal AI
----

docs/docs/solutions/self-hosted.md

@@ -1,3 +0,0 @@
----
-title: Self-Hosted ChatGPT
----

docs/docs/solutions/solutions.md

@@ -1,4 +0,0 @@
----
-title: Overview
-slug: /solutions
----

docs/docusaurus.config.js

@@ -124,12 +124,6 @@ const config = {
           //   position: "left",
           //   label: "Platform",
           // },
-          // {
-          //   type: "docSidebar",
-          //   sidebarId: "solutionsSidebar",
-          //   position: "left",
-          //   label: "Solutions",
-          // },
           {
             type: "docSidebar",
             sidebarId: "companySidebar",
@@ -137,28 +131,18 @@ const config = {
             label: "Company",
           },
           // Navbar right
-          // {
-          //   type: "docSidebar",
-          //   sidebarId: "guidesSidebar",
-          //   position: "right",
-          //   label: "Guides",
-          // },
           {
             type: "docSidebar",
-            sidebarId: "docsSidebar",
+            sidebarId: "guidesSidebar",
+            position: "right",
+            label: "Guides",
+          },
+          {
+            type: "docSidebar",
+            sidebarId: "devSidebar",
             position: "right",
             label: "Developer",
           },
-          // {
-          //   position: "right",
-          //   label: "API",
-          //   to: "/api",
-          // },
-          // {
-          //   href: "https://github.com/janhq/jan",
-          //   label: "GitHub",
-          //   position: "right",
-          // },
         ],
       },
       prism: {

docs/sidebars.js

@@ -4,7 +4,7 @@
  - render a sidebar for each doc of that group
  - provide next/previous navigation
 
- The sidebars can be generated from the filesystem, or explicitly defined here.
+ The sidebars are explicitly defined here.
 
  Create as many sidebars as you want.
  */
@@ -13,19 +13,7 @@
 
 /** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
 const sidebars = {
-  // By default, Docusaurus generates a sidebar from the docs folder structure
-
-  // But you can create a sidebar manually
   featuresSidebar: [
-    "platform/platform",
-    {
-      type: "category",
-      label: "Products",
-      collapsible: true,
-      collapsed: false,
-      link: { type: "doc", id: "products/products" },
-      items: ["products/desktop", "products/mobile", "products/server"],
-    },
     {
       type: "category",
       label: "Features",
@@ -41,33 +29,24 @@ const sidebars = {
     },
   ],
 
-  // Note: Tab name is "Use Cases"
+  // Autogenerate docs from /guides
-  solutionsSidebar: [
+  guidesSidebar: [
-    // "solutions/solutions",
     {
       type: "category",
-      label: "Solutions",
+      label: "Guides",
       collapsible: true,
-      collapsed: false,
+      collapsed: true,
-      items: ["solutions/self-hosted", "solutions/personal-ai"],
+      items: [
+        {
+          type: "autogenerated",
+          dirName: "guides",
+        },
+      ],
     },
-    // {
-    //   type: "category",
-    //   label: "Industries",
-    //   collapsible: true,
-    //   collapsed: false,
-    //   items: [
-    //     "solutions/industries/software",
-    //     "solutions/industries/education",
-    //     "solutions/industries/law",
-    //     "solutions/industries/public-sector",
-    //     "solutions/industries/finance",
-    //     "solutions/industries/healthcare",
-    //   ],
-    // },
   ],
 
-  docsSidebar: [
+  //
+  devSidebar: [
     {
       type: "category",
       label: "Overview",
@@ -75,19 +54,8 @@ const sidebars = {
       collapsed: false,
       items: [
         {
-          type: "doc",
+          type: "autogenerated",
-          label: "Architecture",
+          dirName: "overview",
-          id: "docs/overview/architecture",
-        },
-        {
-          type: "doc",
-          label: "Concepts",
-          id: "docs/overview/concepts",
-        },
-        {
-          type: "doc",
-          label: "App Anatomy",
-          id: "docs/overview/app_anatomy",
         },
       ],
     },
@@ -98,19 +66,8 @@ const sidebars = {
       collapsed: false,
       items: [
         {
-          type: "doc",
+          type: "autogenerated",
-          label: "@janhq/core",
+          dirName: "reference",
-          id: "docs/reference/coreservice",
-        },
-        {
-          type: "doc",
-          label: "@janhq/models",
-          id: "docs/reference/models_catalog",
-        },
-        {
-          type: "doc",
-          label: "@janhq/plugins",
-          id: "docs/reference/plugins_catalog",
         },
       ],
     },
@@ -121,19 +78,8 @@ const sidebars = {
       collapsed: false,
       items: [
         {
-          type: "doc",
+          type: "autogenerated",
-          label: "How to Build a Chat App",
+          dirName: "tutorials",
-          id: "docs/tutorials/build-jan-app",
-        },
-        {
-          type: "doc",
-          label: "How to Build a RAG App",
-          id: "docs/tutorials/build-rag-app",
-        },
-        {
-          type: "doc",
-          label: "How to Publish Apps on Jan",
-          id: "docs/tutorials/publish-jan-app",
         },
       ],
     },
@@ -146,27 +92,12 @@ const sidebars = {
         {
           type: "doc",
           label: "Nitro",
-          id: "docs/articles/nitro",
+          id: "articles/nitro",
         },
       ],
     },
   ],
 
-  // guidesSidebar: [
-  //   {
-  //     type: "category",
-  //     label: "Overview",
-  //     collapsible: true,
-  //     collapsed: true,
-  //     items: [
-  //       {
-  //         type: "doc",
-  //         label: "architecture",
-  //         id: "docs/overview/architecture",
-  //       },
-  //     ],
-  //   },
-  // ],
   companySidebar: [
     // {
     //   type: "category",