docs: restructure public product documentation

.github/workflows/docs.yml

@@ -1,20 +1,32 @@
-name: Docs
+name: Docs checks
 
 on:
   push:
     branches: [main, master]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/docs.yml'
   pull_request:
     branches: [main, master]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/docs.yml'
 
 permissions:
   contents: read
 
 jobs:
-  i18n:
-    name: i18n coverage
+  build:
+    name: Docusaurus build
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
-      - name: Check documentation i18n coverage
-        run: python3 scripts/check-docs-i18n.py
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Install website dependencies
+        working-directory: docs
+        run: npm ci
+      - name: Build documentation
+        working-directory: docs
+        run: npm run build

.github/workflows/docusaurus.yml

@@ -0,0 +1,43 @@
+name: Publish docs via Docusaurus
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - 'docs/**'
+      - '.github/workflows/docusaurus.yml'
+  workflow_dispatch:  # Allow manual trigger
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install website dependencies
+        working-directory: docs
+        run: npm ci
+
+      - name: Build website
+        working-directory: docs
+        run: npm run build
+
+      - name: Deploy website
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/build
+          publish_branch: gh-pages
+          force_orphan: false

.gitignore

@@ -1,4 +1,5 @@
 docs/site/
+docs/website/node_modules/
 examples/**/.work/
 target/
 /store/
@@ -31,3 +32,13 @@ pchronicle-web/dist
 pchronicle-web/target/
 crates/persisting-pchronicle-cli/web-assets/
 .worktrees/
+
+# Docusaurus generated metadata
+docs/website/.docusaurus/
+
+# Docusaurus docs generated from docs/src
+
+# Docusaurus local dependencies and generated output
+docs/node_modules/
+docs/.docusaurus/
+docs/build/

README.md

@@ -22,7 +22,7 @@ review/apply → configured capture → a queryable Dataset.
 ## Install
 
 ```bash
-pip install persisting[lance]
+pip install persisting
 pvisor --version
 pchronicle --version
 ```

benchmark/README.md

@@ -55,7 +55,7 @@ just benchmark-pvisor-compare \
 ### 环境
 
 ```bash
-pip install persisting[lance]
+pip install persisting
 ```
 
 从**仓库根目录**运行（以便正确解析 `persisting` 包）：

benchmark/throughput_stress.py

@@ -6,7 +6,7 @@
     python benchmark/throughput_stress.py --producers 2 --consumers 2 --duration 10
     python benchmark/throughput_stress.py -p 4 -c 4 -d 30 --batch-size 50 --record-size 256
 
-依赖: pip install persisting[lance]
+依赖: pip install persisting
 """
 
 from __future__ import annotations