Update docs setup to the reworked docs action

Move opencloud-service.yml to the repo root, add a docs/intro.md overview
overlay, and point the workflow and dev/build-docs.sh at the action's new
.cache/service-docs layout (action @8956447).

Author: dschmidt

.github/docs/opencloud-service.yml

@@ -31,9 +31,8 @@ jobs:
           cache: false
 
       - id: build
-        uses: dschmidt/opencloud-service-docs-action@6dad19b92b7bdb0351dd637bc49ead2c5b269cfc
+        uses: dschmidt/opencloud-service-docs-action@8956447c5724ba20479b5dea49156d4f5db82116
 
-      # PR dry-run: downloadable site preview, never published.
       - name: Upload PR preview artifact
         if: github.event_name == 'pull_request'
         uses: actions/upload-artifact@v4
@@ -42,7 +41,6 @@ jobs:
           path: ${{ steps.build.outputs.site-path }}
           retention-days: 14
 
-      # Pages-bound artifact for main / manual deploys.
       - name: Upload Pages artifact
         if: github.ref == 'refs/heads/main' || inputs.deploy
         uses: actions/upload-pages-artifact@v3

.github/workflows/docs.yml

@@ -1,6 +1,4 @@
 .env
 
-# Docs build (generated by `make docs`; the site is built + deployed in CI)
-.github/docs/.cache/
-.github/docs/docs/
-docs/generated/
+# Docs build cache (regenerated by `make docs`).
+/.cache/

.gitignore

@@ -13,15 +13,11 @@ vet:
 	go vet ./...
 
 # --- Docs ---
-# Service reference site (env vars, example config, deprecations).
-# Runs dschmidt/opencloud-service-docs-action at the SHA pinned in
-# .github/workflows/docs.yml — identical code path to CI.
-
 docs:
-	DOCS_OUTPUT="$(CURDIR)/docs/generated" bash .github/docs/run.sh
+	bash dev/build-docs.sh
 
 docs-serve-prod:
-	cd .github/docs/.cache/site && pnpm run serve
+	cd .cache/service-docs/site && pnpm run serve
 
 docs-clean:
-	rm -rf .github/docs/.cache docs/generated
+	rm -rf .cache/service-docs

Makefile

@@ -7,10 +7,10 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/.." && cd .. && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 WORKFLOW="$REPO_ROOT/.github/workflows/docs.yml"
 ACTION_REPO="dschmidt/opencloud-service-docs-action"
-ACTION_DIR="$SCRIPT_DIR/.cache/action"
+ACTION_DIR="$REPO_ROOT/.cache/service-docs/action"
 
 REF="$(grep -oE "${ACTION_REPO}@[^ \"']+" "$WORKFLOW" | head -1 | cut -d@ -f2)"
 [ -n "$REF" ] || { echo "error: could not find ${ACTION_REPO}@<ref> in $WORKFLOW" >&2; exit 1; }

.github/docs/run.sh dev/build-docs.sh.github/docs/run.sh renamed to dev/build-docs.sh

@@ -0,0 +1,19 @@
+---
+sidebar_position: 1
+slug: /
+title: Overview
+---
+
+# immichframe-opencloud service reference
+
+immichframe-opencloud serves the [ImmichFrame](https://github.com/immichFrame/ImmichFrame)
+HTTP API from an [OpenCloud](https://opencloud.eu) space instead of an Immich
+server. It reads photos from the space over the LibreGraph (listing) and WebDAV
+(content) APIs, so the ImmichFrame web UI and clients work unchanged.
+
+- **[Environment variables](configuration/environment-variables)** — every env var parsed by the service at startup.
+- **[Example configuration](configuration/example-config)** — YAML config with all defaults.
+- **[Deprecations](configuration/deprecations)** — renamed or removed env vars.
+
+For installation and operational docs see the
+[GitHub repository](https://github.com/dragotin/immichframe-opencloud#readme).

docs/intro.md

@@ -0,0 +1,11 @@
+# Consumed by dschmidt/opencloud-service-docs-action.
+service:
+  name: immichframe
+
+site:
+  title: immichframe-opencloud
+  tagline: ImmichFrame API backed by an OpenCloud space
+
+pins:
+  generator_ref: 80a5711c890de7720f53e585a32cb8be47b27709
+  theme_ref: 0909f2d83e91f107a770ae5da3b8d3127279c26c