Merge pull request #625 from janhq/internal-48

Refactor Jan Documentation

docs/docs/about/about.md

@@ -2,11 +2,11 @@
 title: About Jan
 ---
 
-Jan is a free, open source alternative to OpenAI's platform that runs on your personal computer. 
+Jan is a free, open source alternative to OpenAI's platform that runs on a local folder of open-format files. 
 
 We believe in the need for an open source AI ecosystem, and are building the infra and tooling to allow open source AIs to be as usable and comprehensive as proprietary ones.
 
-Jan's long-term vision is to build a cognitive framework for future robots. We build towards a future where humans and businesses are augmented by practical, useful assistants in everyday life. 
+Jan's long-term vision is to build a cognitive framework for future robots, who are practical, useful assistants for humans and businesses in everyday life. 
 
 ## Why does Jan Exist?
 

docs/docs/guides/overview.md

@@ -1,9 +0,0 @@
----
-title: Overview
-slug: /guides
----
-- Jan Platform: Desktop app/ Cloud native SaaS that can run on Linux, Windows, Mac, or even a Server that comes with extensibilities, toolbox, and state-of-the-art but optimized models for next-gen Apps.
-- Jan App: Next-gen App built on Jan Plaform as `portable intelligence` that can be run everywhere.
-- Models:
-  - Large Language Models
-  - Stable Diffusion models

docs/docusaurus.config.js

@@ -134,13 +134,7 @@ const config = {
           src: "img/logo.svg",
         },
         items: [
-          // Navbar left
-          {
-            type: "docSidebar",
-            sidebarId: "guidesSidebar",
-            position: "left",
-            label: "User Guide",
-          },
+          // Navbar Left
           {
             type: "docSidebar",
             sidebarId: "docsSidebar",

docs/sidebars.js

@@ -29,39 +29,52 @@ const sidebars = {
     },
   ],
 
-  guidesSidebar: [
-    "guides/overview",
+  docsSidebar: [
+    {
+      type: "category",
+      label: "Getting Started",
+      collapsible: false,
+      collapsed: false,
+      items: [
+        "docs/introduction",
         {
           type: "category",
           label: "Installation",
           collapsible: true,
-      collapsed: false,
+          collapsed: true,
           items: [
             {
               type: "autogenerated",
-          dirName: "guides/install",
+              dirName: "getting-started/install",
             },
           ],
         },
-    "guides/troubleshooting",
-  ],
-
-  docsSidebar: [
-    "docs/introduction",
         "docs/quickstart",
+      ],
+    },
     {
       type: "category",
-      label: "Modules",
-      collapsible: true,
+      label: "Building Jan",
+      collapsible: false,
       collapsed: false,
       items: [
+        "docs/user-interface",
         {
-          type: "autogenerated",
-          dirName: "docs/modules",
+          type: "category",
+          label: "Specifications",
+          collapsible: true,
+          collapsed: true,
+          items: [
+            "docs/specs/chats",
+            "docs/specs/models",
+            "docs/specs/threads",
+            "docs/specs/messages",
+            "docs/specs/assistants",
+            "docs/specs/files",
+          ],
         },
       ],
     },
-    "docs/user-interface",
   ],
 
   apiSidebar: [