docs: add MkDocs documentation site and CI example testing

- Reduce README from 370 to ~69 lines as landing page
- Create 30+ MkDocs documentation pages (quickstart, usage guides,
  architecture, Spring Boot, 13 examples, API reference)
- Add GitHub Actions workflow for docs deployment to GitHub Pages
- Add aggregate runAllExamples Gradle task with per-example timeouts
  and failure isolation (90s default, 120s for heavy examples)
- Add GitHub Actions CI workflow running all 13 examples on push/PR
- Configure Spring Boot example with server.port=0 for CI

Author: howtis

.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  examples:
+    name: Run Examples
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Set up Gradle
+        uses: gradle/actions/setup-gradle@v4
+        with:
+          cache-encryption-key: ${{ secrets.GRADLE_ENCRYPTION_KEY }}
+
+      - name: Cache Python standalone
+        uses: actions/cache@v4
+        with:
+          path: ~/.python-embed
+          key: python-standalone-${{ runner.os }}-${{ hashFiles('python-embed-gradle-plugin/src/**') }}
+
+      - name: Make gradlew executable
+        run: chmod +x gradlew
+
+      - name: Run all examples
+        run: ./gradlew :python-embed-examples:runAllExamples
+
+      - name: Upload failure logs
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: example-failure-logs
+          path: |
+            **/build/reports/
+            **/hs_err_pid*.log
+          retention-days: 7

.github/workflows/docs.yml

@@ -0,0 +1,33 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: pip install mkdocs-material
+
+      - name: Build docs
+        run: mkdocs build --strict
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site

.gitignore

@@ -16,3 +16,4 @@ __pycache__/
 Thumbs.db
 *.asc
 gradle.properties
+site/