From ef51dc6c516dff9372a35005c5bece990b15bffd Mon Sep 17 00:00:00 2001
From: Sam Wu <22262939+samjwu@users.noreply.github.com>
Date: Tue, 16 Jul 2024 11:23:25 -0600
Subject: [PATCH] Conditionally skip docs PR build

If there is no change to the docs folder or RTD YAML
compared to the amd-staging branch
---
 amd/hipcc/.readthedocs.yaml | 13 +++++++++++++
 openmp/.readthedocs.yaml    | 13 +++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/amd/hipcc/.readthedocs.yaml b/amd/hipcc/.readthedocs.yaml
index 173be2324e82d0..523980fe04cd0c 100644
--- a/amd/hipcc/.readthedocs.yaml
+++ b/amd/hipcc/.readthedocs.yaml
@@ -16,3 +16,16 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.10"
+  jobs:
+    post_checkout:
+    # Cancel building pull requests when there aren't changed in the docs directory or YAML file.
+    # You can add any other files or directories that you'd like here as well,
+    # like your docs requirements file, or other files that will change your docs build.
+    #
+    # If there are no changes (git diff exits with 0) we force the command to return with 183.
+    # This is a special exit code on Read the Docs that will cancel the build immediately.
+    - |
+      if [ "$READTHEDOCS_VERSION_TYPE" = "external" ] && git diff --quiet origin/amd-staging -- docs/ .readthedocs.yaml;
+      then
+        exit 183;
+      fi
diff --git a/openmp/.readthedocs.yaml b/openmp/.readthedocs.yaml
index 6620c7abff2445..a3dda80bd22097 100644
--- a/openmp/.readthedocs.yaml
+++ b/openmp/.readthedocs.yaml
@@ -16,3 +16,16 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.10"
+  jobs:
+    post_checkout:
+    # Cancel building pull requests when there aren't changed in the docs directory or YAML file.
+    # You can add any other files or directories that you'd like here as well,
+    # like your docs requirements file, or other files that will change your docs build.
+    #
+    # If there are no changes (git diff exits with 0) we force the command to return with 183.
+    # This is a special exit code on Read the Docs that will cancel the build immediately.
+    - |
+      if [ "$READTHEDOCS_VERSION_TYPE" = "external" ] && git diff --quiet origin/amd-staging -- docs/ .readthedocs.yaml;
+      then
+        exit 183;
+      fi