docs: rename HTTP Server to CocoInsight Access and add clarification (#1354)

Author: georgeh0

docs/docs/http_server.mdx renamed to docs/docs/cocoinsight_access.mdx

@@ -1,8 +1,22 @@
 ---
-title: HTTP Server
-description: Run the built-in HTTP server for CocoInsight and health check
+title: CocoInsight Access
+description: Give CocoInsight access to your CocoIndex flows
 ---
 
+## CocoInsight
+
+CocoInsight is a comprehensive web UI to help you understand your flows and interact with the index.
+
+CocoInsight itself has zero data retention with your flows schema and data.
+It talks to your CocoIndex server through HTTP APIs to retrieve flow schema and data when you're using it.
+
+CocoIndex library exposes an HTTP server, mainly for CocoInsight to access your CocoIndex flows and their schema and data.
+
+On YouTube there're a couple videos that give you a quick tour of CocoInsight:
+
+* [Introducing CocoInsight](https://www.youtube.com/watch?v=MMrpUfUcZPk)
+* [Fast Iterate Your Indexing Strategy with CocoInsight](https://www.youtube.com/watch?v=crV7odEVYTE)
+
 ## Start the server
 
 There are two ways to start the server:
@@ -11,8 +25,8 @@ There are two ways to start the server:
 
 Use the `cocoindex server` command. See more options in the [CLI](./core/cli).
 
-- Default bind address: **127.0.0.1:49344** (only exposed locally for safety)
-- Override if you need to expose to all IPs (example: `0.0.0.0:49344`)
+* Default bind address: **127.0.0.1:49344** (only exposed locally for safety)
+* Override if you need to expose to all IPs (example: `0.0.0.0:49344`)
 
 ```sh
 # Start on the default local address (127.0.0.1:49344)
@@ -29,11 +43,11 @@ cocoindex server path/to/app.py \
 
 Flags of interest:
 
-- `-a`, `--address <IP:PORT>`: Bind address (defaults to 127.0.0.1:49344)
-- `-ci`, `--cors-cocoindex`: Allow `https://cocoindex.io` (CocoInsight) to access the server
-- `-c`, `--cors-origin <ORIGINS>`: Comma-separated list of allowed origins
-- `-cl`, `--cors-local <PORT>`: Allow `http://localhost:<PORT>`
-- `-L`, `--live-update`: Enable live updates while the server is running
+* `-a`, `--address <IP:PORT>`: Bind address (defaults to 127.0.0.1:49344)
+* `-ci`, `--cors-cocoindex`: Allow `https://cocoindex.io` (CocoInsight) to access the server
+* `-c`, `--cors-origin <ORIGINS>`: Comma-separated list of allowed origins
+* `-cl`, `--cors-local <PORT>`: Allow `http://localhost:<PORT>`
+* `-L`, `--live-update`: Enable live updates while the server is running
 
 ### Python API
 
@@ -63,17 +77,17 @@ start_server(server_settings)
 
 ## What the server provides today
 
-- **CocoInsight access**: Enable with CLI `-ci`, or by API set `ServerSettings.cors_origins` to `"https://cocoindex.io"`. Then open [https://cocoindex.io/cocoinsight](https://cocoindex.io/cocoinsight) and point it to your server address.
+* **CocoInsight access**: Enable with CLI `-ci`, or by API set `ServerSettings.cors_origins` to `"https://cocoindex.io"`. Then open [https://cocoindex.io/cocoinsight](https://cocoindex.io/cocoinsight) and point it to your server address.
   It'll talk to CocoIndex internal REST APIs exposed through `/cocoindex/api`.
   The internal API is mainly designed for CocoInsight to use today, is subject to change and not considered as stable.
 
-- **Live updates from the CLI**: When running with `-L`, the server performs live updates while it’s up.
+* **Live updates from the CLI**: When running with `-L`, the server performs live updates while it’s up.
   It's doing same thing as `cocoindex update -L` while the HTTP server is running.
 
-- **Health check**: `GET /healthz` responds with `application/json`:
+* **Health check**: `GET /healthz` responds with `application/json`:
 
-  - `status`: always `"ok"` when healthy
-  - `version`: the build-time package version (e.g., `"0.3.5"`)
+  * `status`: always `"ok"` when healthy
+  * `version`: the build-time package version (e.g., `"0.3.5"`)
 
   Example response:
 

docs/docusaurus.config.ts

@@ -78,6 +78,10 @@ const config: Config = {
             from: '/ops/sources',
             to: '/sources',
           },
+          {
+            from: '/http_server',
+            to: '/cocoinsight_access',
+          },
         ],
       },
     ],

docs/sidebars.ts

@@ -76,8 +76,8 @@ const sidebars: SidebarsConfig = {
     },
     {
       type: 'doc',
-      id: 'http_server',
-      label: 'HTTP Server',
+      id: 'cocoinsight_access',
+      label: 'CocoInsight Access',
     },
     {
       type: 'doc',