docs: only trigger doc pages rebuild when modifying the doc folder

.github/workflows/docs.yml

@@ -1,9 +1,9 @@
 name: docs
 on:
   push:
-    branches:
+    branches: [master, main]
-      - master 
+    paths:
-      - main
+      - 'docs/**'
 permissions:
   contents: write
 jobs:

.readthedocs.yaml

@@ -7,6 +7,19 @@ build:
   os: ubuntu-lts-latest
   tools:
     python: latest
+  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/main -- docs/ .readthedocs.yaml;
+        then
+          exit 183;
+        fi
 mkdocs:
   configuration: mkdocs.yml
 # Optionally declare the Python requirements required to build your docs