Skip docs deployment gracefully when GitHub Pages is disabled

- Add pages-enabled check in deploy-docs gate
- Skip deploy-docs with notice when Pages is not enabled
- Keep docs URL visible in summary and docs guidance

Made-with: Cursor

Author: Hongwei-MB

.github/workflows/ci.yml

@@ -462,34 +462,48 @@ jobs:
       - name: Check for DocFX configuration
         id: check-docs
         shell: bash
+        env:
+          GH_TOKEN: ${{ github.token }}
         run: |
+          HAS_DOCS="false"
           if [ -f "docs/docfx.json" ]; then
-            echo "has_docs=true" >> "$GITHUB_OUTPUT"
+            HAS_DOCS="true"
           else
             echo "::notice::No docs/docfx.json found. Skipping documentation deployment."
-            echo "has_docs=false" >> "$GITHUB_OUTPUT"
+          fi
+
+          HAS_PAGES="$(gh api repos/${{ github.repository }} --jq '.has_pages' 2>/dev/null || echo "false")"
+          if [ "$HAS_PAGES" != "true" ]; then
+            echo "::notice::GitHub Pages is not enabled. Enable Settings > Pages > Source: GitHub Actions."
+            HAS_PAGES="false"
+          fi
+
+          if [ "$HAS_DOCS" = "true" ] && [ "$HAS_PAGES" = "true" ]; then
+            echo "should_deploy=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "should_deploy=false" >> "$GITHUB_OUTPUT"
           fi
 
       - uses: actions/setup-dotnet@v5
-        if: steps.check-docs.outputs.has_docs == 'true'
+        if: steps.check-docs.outputs.should_deploy == 'true'
         with:
           global-json-file: global.json
 
       - name: Restore .NET tools
-        if: steps.check-docs.outputs.has_docs == 'true'
+        if: steps.check-docs.outputs.should_deploy == 'true'
         run: dotnet tool restore
 
       - name: Build documentation
-        if: steps.check-docs.outputs.has_docs == 'true'
+        if: steps.check-docs.outputs.should_deploy == 'true'
         run: dotnet docfx docs/docfx.json
 
       - name: Upload pages artifact
-        if: steps.check-docs.outputs.has_docs == 'true'
+        if: steps.check-docs.outputs.should_deploy == 'true'
         uses: actions/upload-pages-artifact@v3
         with:
           path: docs/_site
 
       - name: Deploy to GitHub Pages
-        if: steps.check-docs.outputs.has_docs == 'true'
+        if: steps.check-docs.outputs.should_deploy == 'true'
         id: deployment
         uses: actions/deploy-pages@v4

README.md

@@ -154,6 +154,7 @@ To enable automatic documentation deployment to GitHub Pages:
 4. Expected docs URL: `https://<owner>.github.io/<repo>/` (for this repo: `https://agibuild.github.io/dotnet.CI.template/`)
 
 The `Resolve Version` job summary always shows this expected docs URL, even when docs deployment is skipped.
+If Pages is not enabled, `deploy-docs` is skipped with a notice instead of failing the whole workflow.
 
 ---
 

docs/github-workflows-guide.md

@@ -60,7 +60,7 @@ push / PR to main + weekly
 ### `deploy-docs`
 - 依赖 `release` 成功后自动运行
 - 如果存在 `docs/docfx.json`，构建 DocFX 并部署到 GitHub Pages
-- 如果不存在则跳过
+- 如果未启用 GitHub Pages 或缺少 DocFX 配置，则自动跳过并给出 notice，不会导致整条流水线失败
 
 ---