chore: adjust side bar and menu

docs/features/minification.md → docs/advanced/minification.md

@@ -17,3 +17,5 @@ If minify is enabled:
 :::note
 Farm use swc minifier under the hood, all options of swc minifier can be used in Farm.
 :::
+
+## minify options

docs/advanced/ssr.md

@@ -0,0 +1 @@
+# Server-Side Rendering (SSR)

docs/community.md

@@ -0,0 +1 @@
+# Community

docs/comparisons.md

@@ -0,0 +1 @@
+# Comparisons

docs/concepts.md

@@ -1,8 +1,6 @@
 # Concepts
-Farm is a build tool to transform and bundle your `input` to `deployable resources`. Farm will search modules start from the input, then construct a module graph and bundle these modules into several `resources`
+Farm is a build tool to transform and bundle your `input` to `deployable resources`. Farm will search modules start from the input, then construct a module graph and bundle these modules into several `resources`.
 
-Main Concepts:
-* **Input**
-* **Output**
-* **Plugins**
-* **Partial Bundling**
+figure1: Input all kinds of resources and compile them into production resources.
+
+figure2: Farm architecture, Corperation of Server, Compiler, Watcher, and Plugins.

docs/config/compilation-options.md

@@ -1,4 +1,4 @@
-# Configuration Reference
+# Compiler Options
 
 By default, Farm reads the configuration from the `farm.config.ts|js|mjs` file in the project root directory, an example configuration file:
 

docs/config/configuring-farm.md

@@ -0,0 +1,23 @@
+# Configuring Farm
+
+By default, Farm reads the configuration from the `farm.config.ts|js|mjs` file in the project root directory, an example configuration file:
+
+```ts title="farm.config.ts" {5-7}
+import { defineConfig } from "@farmfe/core";
+export default defineConfig({
+  root: process.cwd(), // compiled root directory
+  // compile options
+  compilation: {
+    //...
+  },
+  // Dev Server options
+  server: {
+    hmr: true,
+    //...
+  },
+  // plugin configuration
+  plugins: [],
+});
+```
+
+This document only covers details `compilation` options. For `server` or `shared` options, refer to [server](/docs/config/dev-server) or [shared](/docs/config/shared).

docs/config/dev-server.md

@@ -1,4 +1,4 @@
-# Dev Server
+# Dev Server Options
 
 ## DevServer Options - server
 

docs/features/css.md

@@ -1,4 +1,4 @@
-# Css
+# Css/Sass/Less
 Farm support Css out of box, just import the css file:
 
 ```tsx

docs/features/dev-server.md

@@ -0,0 +1 @@
+# DevServer and HMR

docs/features/env.md

@@ -0,0 +1 @@
+# Enviroment Variables and Modes

docs/features/script.md

@@ -1,5 +1,4 @@
-# Script
-
+# TS/TSX
 Farm support compiling `Js/Jsx/Ts/Tsx` out of box, and compile `Jsx/Tsx` to React by default.
 
 ```tsx title="./button.tsx"

docs/migration/from-vite.md

@@ -0,0 +1 @@
+# Migrate From Vite

docusaurus.config.js

@@ -123,12 +123,24 @@ const config = {
             position: "left",
             label: "Config",
           },
+          {
+            type: "doc",
+            docId: "api/rust-plugin-api",
+            position: "left",
+            label: "API",
+          },
           {
             type: "doc",
             docId: "plugins/official-plugins/overview",
             position: "left",
             label: "Plugins",
           },
+          {
+            type: "doc",
+            docId: "community",
+            position: "left",
+            label: "Community",
+          },
           {
             type: "docsVersionDropdown",
             position: "right",

sidebars.js

@@ -22,7 +22,7 @@ const sidebars = {
       type: "category",
       label: "Getting Started",
       collapsed: false,
-      items: ["why-farm", "quick-start", "using-plugins"],
+      items: ["why-farm", "quick-start", "concepts", "using-plugins"],
     },
     {
       type: "category",
@@ -40,40 +40,62 @@ const sidebars = {
       label: "Features",
       collapsed: true,
       items: [
+        "features/dev-server",
         "features/html",
         "features/css",
         "features/script",
         "features/static",
+        "features/env",
         "features/lazy-compilation",
-        "features/partial-bundling",
         "features/sourcemap",
-        "features/tree-shake",
-        "features/minification",
-        "features/polyfill",
-        "features/persistent-cache",
       ],
     },
+    {
+      type: "category",
+      label: "Advanced",
+      collapsed: true,
+      items: [
+        "advanced/ssr",
+        "advanced/partial-bundling",
+        "advanced/tree-shake",
+        "advanced/minification",
+        "advanced/polyfill",
+        "advanced/persistent-cache"
+      ],
+    },
+    {
+      type: "category",
+      label: "Migration",
+      collapsed: true,
+      items: ["migration/from-vite"],
+    },
+    "comparisons",
     "benchmark",
-    // {
-    //   type: "category",
-    //   label: "Benchmark",
-    //   collapsed: false,
-    //   items: ["benchmark"],
-    // },
   ],
   configSidebar: [
     {
       type: "category",
       label: "Configuration Reference",
       collapsed: false,
       items: [
+        "config/configuring-farm",
         "config/compilation-options",
         "config/dev-server",
         "config/shared",
         "config/environment-variable",
         "config/plugins-options",
       ],
     },
+    {
+      type: "category",
+      label: "CLI",
+      collapsed: false,
+      items: ["cli/cli-api"],
+    },
+    // "config/farm-config",
+    // "config/cli",
+  ],
+  apiSidebar: [
     {
       type: "category",
       label: "Api Reference",
@@ -86,14 +108,6 @@ const sidebars = {
         "api/rust-api",
       ],
     },
-    {
-      type: "category",
-      label: "CLI",
-      collapsed: false,
-      items: ["cli/cli-api"],
-    },
-    // "config/farm-config",
-    // "config/cli",
   ],
   pluginSidebar: [
     {