From da095b1591e059f0ce36ae26bfffc0f97ee7a236 Mon Sep 17 00:00:00 2001
From: Johannes Braun <29555657+joBr99@users.noreply.github.com>
Date: Sun, 22 Feb 2026 00:53:27 +0100
Subject: [PATCH] migration mkdocs

---
 .github/workflows/docs-dev.yml                | 28 --------------
 .github/workflows/docs-release.yml            | 38 ++++++++++++++-----
 .github/workflows/docs-standalone-release.yml | 25 ------------
 3 files changed, 29 insertions(+), 62 deletions(-)
 delete mode 100644 .github/workflows/docs-dev.yml
 delete mode 100644 .github/workflows/docs-standalone-release.yml

diff --git a/.github/workflows/docs-dev.yml b/.github/workflows/docs-dev.yml
deleted file mode 100644
index 8333f29a..00000000
--- a/.github/workflows/docs-dev.yml
+++ /dev/null
@@ -1,28 +0,0 @@
-name: docs-ci
-
-on:
-  workflow_dispatch:
-  push:
-    branches:
-      - dev
-    paths:
-      - docs/*
-      - .github/workflows/docs.yml
-      - mkdocs.yml
-      - HMI/README.md
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-python@v6
-        with:
-          python-version: 3.x
-      - run: pip install mkdocs-material mkdocs-video markdown-include mike
-      - run: cp HMI/README.md docs/hmi-serial-protocol.md
-      - run: git config --global user.name Docs deploy
-      - run: git config --global user.email docs@dummy.bot.com
-      - run: mike deploy --push --update-aliases dev
diff --git a/.github/workflows/docs-release.yml b/.github/workflows/docs-release.yml
index a0ab482b..39364ce8 100644
--- a/.github/workflows/docs-release.yml
+++ b/.github/workflows/docs-release.yml
@@ -6,24 +6,44 @@ on:
     branches:
       - main
     paths:
-      - docs/*
+      - docs/**
+      - docs-standalone/**
       - .github/workflows/docs-release.yml
       - mkdocs.yml
+      - docs-standalone/mkdocs.yml
       - HMI/README.md
 
 jobs:
-  deploy:
+  build:
     runs-on: ubuntu-latest
     steps:
+      - uses: actions/configure-pages@v5
       - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
       - uses: actions/setup-python@v6
         with:
           python-version: 3.x
-      - run: pip install mkdocs-material mkdocs-video markdown-include mike
+      - run: pip install zensical
       - run: cp HMI/README.md docs/hmi-serial-protocol.md
-      - run: git config --global user.name Docs deploy
-      - run: git config --global user.email docs@dummy.bot.com
-      - run: mike set-default stable
-      - run: mike deploy --push --update-aliases stable
+      - run: zensical build --config-file mkdocs.yml
+      - run: zensical build --config-file docs-standalone/mkdocs.yml
+      - run: mkdir -p _site/standalone _site/stable
+      - run: cp -a site/. _site/
+      - run: cp -a site/. _site/stable/
+      - run: cp -a site-standalone/. _site/standalone/
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: _site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.github/workflows/docs-standalone-release.yml b/.github/workflows/docs-standalone-release.yml
deleted file mode 100644
index 067bf494..00000000
--- a/.github/workflows/docs-standalone-release.yml
+++ /dev/null
@@ -1,25 +0,0 @@
-name: docs-standalone-ci
-
-on:
-  workflow_dispatch:
-  push:
-    branches:
-      - main
-    paths:
-      - docs-standalone/**
-      - .github/workflows/docs-standalone-release.yml
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-python@v6
-        with:
-          python-version: 3.x
-      - run: pip install mkdocs-material mike
-      - run: git config --global user.name Docs deploy
-      - run: git config --global user.email docs@dummy.bot.com
-      - run: mike deploy --config-file docs-standalone/mkdocs.yml --push --update-aliases standalone