docs: prepare github pages for better documentation

Author: buehner

.github/workflows/pages.yml

@@ -0,0 +1,31 @@
+name: Pages
+on:
+  push:
+    paths:
+        - 'docs/**.md'
+        - 'mkdocs.yml'
+        - '.github/workflows/pages.yml'
+    branches: [ main ]
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
+        with:
+          python-version: 3.13
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@0c907a75c2c80ebcb7f088228285e798b750cf8f # v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force

docs/index.md

@@ -0,0 +1,3 @@
+# Welcome to the GeoServer Dockerfile documentation
+
+This is just a placeholder for future documentation.

mkdocs.yml

@@ -0,0 +1,32 @@
+site_name: GeoServer Dockerfile Documentation
+repo_url: https://github.com/geoserver/docker
+nav:
+- Home: index.md
+theme:
+  name: material
+  language: en
+  icon:
+    logo: material/library-outline
+  font:
+    text: Roboto
+  features:
+  - content.tooltips
+  - content.code.copy
+  palette:
+  # Palette toggle for dark mode
+  - media: "(prefers-color-scheme: dark)"
+    scheme: slate
+    primary: black
+    accent: indigo
+    toggle:
+      icon: material/weather-night
+      name: Switch to light mode
+      # Palette toggle for light mode
+  - media: "(prefers-color-scheme: light)"
+
+    scheme: default
+    primary: black
+    accent: indigo
+    toggle:
+      icon: material/weather-sunny
+      name: Switch to dark mode