Restructure docs into User Guide and Developer Guide streams (#367)

* Restructure docs into User Guide and Developer Guide streams

- Split flat docs/ into docs/user/ (11 pages) and docs/developer/ (8 pages)
- User Guide: configuration, layout, notebooks, launch, dark mode, code
  highlighting, git metadata, text color schemes, RTL support, stderr warnings
- Developer Guide: setup, architecture, assets, testing, visual testing,
  release process, multilingual plan
- Split oversized configure.md (587 lines) into focused topic pages
- Consolidate contributing/ and CONTRIBUTING.md content into developer/
- Move PLAN_MULTILINGUAL_SUPPORT.md into developer/multilingual.md
- Move RTL_SUPPORT.md into user/rtl-support.md
- Add .github/workflows/docs.yml for GitHub Pages deployment
- Update conf.py: nb_execution_mode=auto, exclude RTL_SUPPORT.md
- Fix folium Stamen Terrain deprecation in notebooks.md
- Rewrite landing page (docs/index.md) with two-stream navigation

* Address Copilot review feedback

- Fix missing trailing comma in sphinx_thebe extension example (launch.md)
- Use npm ci instead of npm install in CI workflow (docs.yml)
- Rephrase emphasis description to reference em element (text-color-schemes.md)
- Fix typo: 'You an also' -> 'You can also' (notebooks.md)
- Fix capitalization: 'Javascript' -> 'JavaScript' (notebooks.md)

Author: mmcky

.github/workflows/docs.yml

@@ -0,0 +1,68 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0  # Full history for git-based metadata
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "18"
+          cache: "npm"
+
+      - name: Install Node.js dependencies and build assets
+        run: |
+          npm ci
+          npm run build
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .[doc]
+
+      - name: Build documentation
+        run: |
+          sphinx-build -n --keep-going -b html docs/ docs/_build/html
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

docs/conf.py

@@ -28,7 +28,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "RTL_SUPPORT.md"]
 
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3.8", None),
@@ -57,7 +57,7 @@
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ["_static"]
-nb_execution_mode = "cache"
+nb_execution_mode = "auto"
 
 # -- Togglebutton configuration ----------------------------------------------
 togglebutton_hint = "Show"