From 5e5f2dffee1b7090cf23917cea2b5186edab2434 Mon Sep 17 00:00:00 2001
From: Mendon Kissling <59585235+mendonk@users.noreply.github.com>
Date: Tue, 2 Sep 2025 16:59:01 -0400
Subject: [PATCH] ci: allow docs-only PRs to skip nightly status - second
 attempt (#9618)

* add-docs-only-logic-to-workflow

* fix-linter-error
---
 .github/workflows/ci.yml | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 17b2fc53c1..3c0116b7a7 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -147,6 +147,19 @@ jobs:
       workspace: ${{ steps.filter.outputs.workspace }}
       api: ${{ steps.filter.outputs.api }}
       database: ${{ steps.filter.outputs.database }}
+      docs-only: ${{
+        steps.filter.outputs.docs == 'true' &&
+        steps.filter.outputs.python != 'true' &&
+        steps.filter.outputs.frontend != 'true' &&
+        steps.filter.outputs['frontend-tests'] != 'true' &&
+        steps.filter.outputs['components-changes'] != 'true' &&
+        steps.filter.outputs['starter-projects-changes'] != 'true' &&
+        steps.filter.outputs['starter-projects'] != 'true' &&
+        steps.filter.outputs.components != 'true' &&
+        steps.filter.outputs.workspace != 'true' &&
+        steps.filter.outputs.api != 'true' &&
+        steps.filter.outputs.database != 'true'
+        }}
 
     steps:
       - name: Checkout code
@@ -255,9 +268,11 @@ jobs:
     env:
       JOBS_JSON: ${{ toJSON(needs) }}
       RESULTS_JSON: ${{ toJSON(needs.*.result) }}
+      # Skip nightly build check if only docs files changed
+      DOCS_ONLY: ${{ needs.path-filter.outputs.docs-only }}
       EXIT_CODE: ${{ (contains(needs.*.result, 'failure') ||
                       contains(needs.*.result, 'cancelled') ||
-                      (needs.check-nightly-status.outputs.should-proceed != 'true' && github.event_name != 'workflow_dispatch'))
+                      (needs.check-nightly-status.outputs.should-proceed != 'true' && github.event_name != 'workflow_dispatch' && needs.path-filter.outputs.docs-only != 'true'))
                       && '1' || '0' }}
     steps:
       - name: "CI Success"
@@ -267,6 +282,10 @@ jobs:
           echo "Should run CI: ${{ needs.set-ci-condition.outputs.should-run-ci }}"
           echo "Nightly build status: ${{ needs.check-nightly-status.outputs.should-proceed }}"
           echo "Event type: ${{ github.event_name }}"
+          echo "Docs only changes: $DOCS_ONLY"
+          echo "Python changes: ${{ needs.path-filter.outputs.python }}"
+          echo "Frontend changes: ${{ needs.path-filter.outputs.frontend }}"
+          echo "Docs changes: ${{ needs.path-filter.outputs.docs }}"
           echo ""
 
           # Check for job failures
@@ -316,7 +335,7 @@ jobs:
             echo "  1. Check if the cancellation was intentional"
             echo "  2. Re-run the workflow if needed"
 
-          elif [[ "${{ needs.check-nightly-status.outputs.should-proceed }}" != "true" && "${{ github.event_name }}" != "workflow_dispatch" ]]; then
+          elif [[ "${{ needs.check-nightly-status.outputs.should-proceed }}" != "true" && "${{ github.event_name }}" != "workflow_dispatch" && "$DOCS_ONLY" != "true" ]]; then
             echo "🚫 CI BLOCKED: Nightly build is broken"
             echo ""
             echo "The nightly PyPI package was not updated today, indicating the nightly build failed."
@@ -326,6 +345,7 @@ jobs:
             echo "  2. Check the nightly build logs for errors"
             echo "  3. Once the nightly build is fixed and publishes successfully, re-run this workflow"
             echo "  4. Alternatively, use 'workflow_dispatch' to manually override this check if needed"
+            echo "  5. Note: PRs with only documentation changes can bypass this check"
 
           else
             echo "✅ CI SUCCESS: All checks passed!"
@@ -338,4 +358,4 @@ jobs:
 
           echo ""
           echo "Exit code: $EXIT_CODE"
-          exit $EXIT_CODE
+          exit $EXIT_CODE
\ No newline at end of file