add docs publishing workflow

Author: jonathan343

.github/workflows/docs.yml

@@ -0,0 +1,30 @@
+name: docs
+on:
+  push:
+    branches:
+      - smithy-python-docs
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - 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@v6
+        with:
+          python-version: 3.12.x
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: uv sync --group docs
+      - run: uv run mkdocs gh-deploy --force

pyproject.toml

@@ -26,7 +26,7 @@ changelog = [
 ]
 docs = [
     "mkdocs-material~=9.6.20",
-    "mkdocstrings-python~=0.30.1"
+    "mkdocstrings-python~=1.18.2"
 ]
 
 [tool.uv]