From dcd8714cc0551762675bef5b63f00e9f816cb612 Mon Sep 17 00:00:00 2001
From: Will Sarg <12886992+willsarg@users.noreply.github.com>
Date: Tue, 17 Feb 2026 16:24:26 -0500
Subject: [PATCH] ci: enforce docs-quality in required gate on push (#672)

---
 .github/workflows/ci.yml | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 9dc5186..2709211 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -315,7 +315,9 @@ jobs:
 
                   event_name="${{ github.event_name }}"
                   rust_changed="${{ needs.changes.outputs.rust_changed }}"
+                  docs_changed="${{ needs.changes.outputs.docs_changed }}"
                   workflow_changed="${{ needs.changes.outputs.workflow_changed }}"
+                  docs_result="${{ needs.docs-quality.result }}"
                   workflow_owner_result="${{ needs.workflow-owner-approval.result }}"
 
                   if [ "${{ needs.changes.outputs.docs_only }}" = "true" ]; then
@@ -324,6 +326,10 @@ jobs:
                       echo "Workflow files changed but workflow owner approval gate did not pass."
                       exit 1
                     fi
+                    if [ "$event_name" != "pull_request" ] && [ "$docs_changed" = "true" ] && [ "$docs_result" != "success" ]; then
+                      echo "Docs-only push changed docs, but docs-quality did not pass."
+                      exit 1
+                    fi
                     echo "Docs-only fast path passed."
                     exit 0
                   fi
@@ -335,6 +341,10 @@ jobs:
                       echo "Workflow files changed but workflow owner approval gate did not pass."
                       exit 1
                     fi
+                    if [ "$event_name" != "pull_request" ] && [ "$docs_changed" = "true" ] && [ "$docs_result" != "success" ]; then
+                      echo "Non-rust push changed docs, but docs-quality did not pass."
+                      exit 1
+                    fi
                     echo "Non-rust fast path passed."
                     exit 0
                   fi
@@ -348,6 +358,7 @@ jobs:
                   echo "lint_strict_delta=${lint_strict_delta_result}"
                   echo "test=${test_result}"
                   echo "build=${build_result}"
+                  echo "docs=${docs_result}"
                   echo "workflow_owner_approval=${workflow_owner_result}"
 
                   if [ "$workflow_changed" = "true" ] && [ "$workflow_owner_result" != "success" ]; then
@@ -369,4 +380,9 @@ jobs:
                     exit 1
                   fi
 
+                  if [ "$docs_changed" = "true" ] && [ "$docs_result" != "success" ]; then
+                    echo "Push changed docs, but docs-quality did not pass."
+                    exit 1
+                  fi
+
                   echo "Push required checks passed."