From 1dcf756e087cb7882ba21059e1343545004bc32b Mon Sep 17 00:00:00 2001
From: Rachel Brindle <you@subluminal.net>
Date: Sat, 30 Mar 2024 14:47:12 -0700
Subject: [PATCH] Build docs as part of github

---
 .github/workflows/documentation.yml | 22 ++++++++++++++++++++++
 script/build_docs.zsh               |  7 ++-----
 script/release                      |  6 +-----
 3 files changed, 25 insertions(+), 10 deletions(-)
 create mode 100644 .github/workflows/documentation.yml

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
new file mode 100644
index 000000000..a59367d55
--- /dev/null
+++ b/.github/workflows/documentation.yml
@@ -0,0 +1,22 @@
+name: Build Documentation
+on: push
+
+permissions:
+  contents: write
+
+jobs:
+  build-documentation:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Build Docs
+        run: |
+          ./script/build_docs.zsh
+
+      - name: Deploy Docs
+        if: github.ref == 'refs/heads/main'
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          folder: docs
diff --git a/script/build_docs.zsh b/script/build_docs.zsh
index cac9eddff..6a2e0666a 100755
--- a/script/build_docs.zsh
+++ b/script/build_docs.zsh
@@ -1,15 +1,12 @@
 #!/bin/zsh
 
-GIT_ROOT=$(git rev-parse --show-toplevel)
-pushd "${GIT_ROOT}" 2>&1 >/dev/null
-
 export DOCC_JSON_PRETTYPRINT="YES"
 
+mkdir -p docs
+
 swift package --allow-writing-to-directory docs \
     generate-documentation --target Nimble \
     --disable-indexing \
     --transform-for-static-hosting \
     --hosting-base-path 'https://quick.github.io/Nimble' \
     --output-path docs
-
-popd
diff --git a/script/release b/script/release
index 742dbcfdb..ba0d03394 100755
--- a/script/release
+++ b/script/release
@@ -127,11 +127,7 @@ else
 
     git add ${PODSPEC} || { restore_podspec; die "Failed to add ${PODSPEC} to INDEX"; }
 
-    echo "--- Updating Docs ---"
-    ./script/build_docs.zsh
-    git add docs || { git co docs; die "Failed to add docs to INDEX"; }
-
-    git commit -m "[$VERSION_TAG] Update docs and podspec" || { restore_podspec; die "Failed to push updated version: $VERSION"; }
+    git commit -m "[$VERSION_TAG] Update podspec" || { restore_podspec; die "Failed to push updated version: $VERSION"; }
 fi
 
 RELEASE_NOTES="Version ${VERSION}. Open https://github.com/Quick/Nimble/releases/tag/$VERSION_TAG for full release notes."