Build docs as part of github

.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

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

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."