diff --git a/.github/workflows/check-docs-syntax.yml b/.github/workflows/check-docs-syntax.yml
index 1c089c9b2c..3a3b272e94 100644
--- a/.github/workflows/check-docs-syntax.yml
+++ b/.github/workflows/check-docs-syntax.yml
@@ -179,7 +179,11 @@ jobs:
             }
 
       - name: Resolve previous failure comment on success
-        if: success() && (steps.changed.outputs.count != '0' || steps.changed.outputs.paramsChanged == 'true')
+        # Clear any stale failure comment whenever this workflow run is green,
+        # even if the syntax checker step was skipped (e.g. when a later
+        # commit reverts the earlier failure so no markdown files appear in
+        # the PR's net diff).
+        if: success()
         uses: actions/github-script@v7
         with:
           script: |