From baf32f3731499f20da78afd2ffe6afb9c76631fb Mon Sep 17 00:00:00 2001
From: Edoardo Zoni <59625522+EZoni@users.noreply.github.com>
Date: Fri, 11 Oct 2024 14:26:10 -0700
Subject: [PATCH] CI: skip build/test jobs if only `Docs/` is modified (#5387)

Could we do this to make sure that we run the GitHub Actions and Azure
jobs (build, test) only if _at least one file outside the_ `Docs`
_directory_ is modified, i.e., skip those jobs if only files in the
`Docs` directory are modified?

I think it would be safe to do so (and a bit of a waste of resources to
not do so...), but I leave it open for discussion.

If merged, we could test this rebasing #5386 and seeing if the correct
CI jobs are skipped.

Note that this PR leaves the other CI jobs untouched, e.g., `source`,
`docs`, `CodeQL`, etc.
---
 .azure-pipelines.yml                   | 3 +++
 .github/workflows/clang_sanitizers.yml | 2 ++
 .github/workflows/clang_tidy.yml       | 2 ++
 .github/workflows/cuda.yml             | 2 ++
 .github/workflows/hip.yml              | 2 ++
 .github/workflows/insitu.yml           | 2 ++
 .github/workflows/intel.yml            | 2 ++
 .github/workflows/macos.yml            | 2 ++
 .github/workflows/ubuntu.yml           | 2 ++
 .github/workflows/windows.yml          | 2 ++
 10 files changed, 21 insertions(+)

diff --git a/.azure-pipelines.yml b/.azure-pipelines.yml
index a32ecb8fa24..607edecedd6 100644
--- a/.azure-pipelines.yml
+++ b/.azure-pipelines.yml
@@ -9,6 +9,9 @@ pr:
   branches:
     include:
     - development
+  paths:
+    exclude:
+    - Docs
 
 jobs:
 - job:
diff --git a/.github/workflows/clang_sanitizers.yml b/.github/workflows/clang_sanitizers.yml
index 067488911bb..e89cb676a03 100644
--- a/.github/workflows/clang_sanitizers.yml
+++ b/.github/workflows/clang_sanitizers.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-clangsanitizers
diff --git a/.github/workflows/clang_tidy.yml b/.github/workflows/clang_tidy.yml
index 9088e3af134..edb3e8b1988 100644
--- a/.github/workflows/clang_tidy.yml
+++ b/.github/workflows/clang_tidy.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-clangtidy
diff --git a/.github/workflows/cuda.yml b/.github/workflows/cuda.yml
index 2209f425d1f..a4fc4e49ace 100644
--- a/.github/workflows/cuda.yml
+++ b/.github/workflows/cuda.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-cuda
diff --git a/.github/workflows/hip.yml b/.github/workflows/hip.yml
index 12513caa19a..8ba39de7742 100644
--- a/.github/workflows/hip.yml
+++ b/.github/workflows/hip.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-hip
diff --git a/.github/workflows/insitu.yml b/.github/workflows/insitu.yml
index 0cc6a1ced5e..50b482d28d3 100644
--- a/.github/workflows/insitu.yml
+++ b/.github/workflows/insitu.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-insituvis
diff --git a/.github/workflows/intel.yml b/.github/workflows/intel.yml
index f27181c2e20..170008d0672 100644
--- a/.github/workflows/intel.yml
+++ b/.github/workflows/intel.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-intel
diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml
index 0afaf6ea451..069567d39ec 100644
--- a/.github/workflows/macos.yml
+++ b/.github/workflows/macos.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-macos
diff --git a/.github/workflows/ubuntu.yml b/.github/workflows/ubuntu.yml
index 6435ed7e66a..bbe20679781 100644
--- a/.github/workflows/ubuntu.yml
+++ b/.github/workflows/ubuntu.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-ubuntu
diff --git a/.github/workflows/windows.yml b/.github/workflows/windows.yml
index 1d8b0fd0495..ae4843e0536 100644
--- a/.github/workflows/windows.yml
+++ b/.github/workflows/windows.yml
@@ -5,6 +5,8 @@ on:
     branches:
       - "development"
   pull_request:
+    paths-ignore:
+      - "Docs/**"
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-windows