Make GitHub Pages deployment conditional in docs workflow (#35)

* Initial plan

* Add conditional check to skip GitHub Pages deployment if not configured

Co-authored-by: aih <217356+aih@users.noreply.github.com>

* Fix shellcheck issues in docs-deploy workflow

Co-authored-by: aih <217356+aih@users.noreply.github.com>

* Remove actionlint binary and update .gitignore

Co-authored-by: aih <217356+aih@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: aih <217356+aih@users.noreply.github.com>

Author: Copilot

.github/workflows/docs-deploy.yml

@@ -17,9 +17,6 @@ concurrency:
 
 jobs:
   deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -37,11 +34,32 @@ jobs:
       - name: Build site
         run: mkdocs build
 
+      - name: Check if GitHub Pages is configured
+        id: check_pages
+        continue-on-error: true
+        run: |
+          # Check if the pages environment exists by checking repository settings
+          if gh api "repos/${{ github.repository }}/pages" &>/dev/null; then
+            echo "pages_enabled=true" >> "$GITHUB_OUTPUT"
+            echo "GitHub Pages is configured"
+          else
+            echo "pages_enabled=false" >> "$GITHUB_OUTPUT"
+            echo "GitHub Pages is not configured - skipping deployment"
+          fi
+        env:
+          GH_TOKEN: ${{ github.token }}
+
       - name: Upload artifact
+        if: steps.check_pages.outputs.pages_enabled == 'true'
         uses: actions/upload-pages-artifact@v3
         with:
           path: ./site
 
+      - name: Setup Pages environment
+        if: steps.check_pages.outputs.pages_enabled == 'true'
+        uses: actions/configure-pages@v5
+
       - name: Deploy to GitHub Pages
+        if: steps.check_pages.outputs.pages_enabled == 'true'
         id: deployment
         uses: actions/deploy-pages@v4

.gitignore

@@ -4,3 +4,4 @@ tests/reports/
 
 # MkDocs
 site/
+actionlint