Action to auto-trigger docs build in readthedocs -> Main (#148)

Author: liudmylaru

.github/workflows/publish-to-readthedocs.yml

@@ -0,0 +1,40 @@
+name: "Publish Docs"
+
+on:
+  # Auto-trigger this workflow on tag creation
+  push:
+    tags:
+      - 'v*.*.*'
+  # Auto-trigger this workflow on merge to main changes in docs/** folder
+  pull_request_target:
+    types:
+      - closed
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+
+jobs:
+  build-n-publish:
+    name: Build and publish Docs 📖 to Readthedocs
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: When PR ✅ merged - Trigger Readthedocs build
+        if: github.event.pull_request.merged == true
+        env:
+          RTDS_ADS_PROJECT: https://readthedocs.org/api/v3/projects/accelerated-data-science
+          RTDS_ADS_TOKEN: ${{ secrets.RTDS_ADS_TOKEN }}
+        run: |
+          curl \
+            -X POST \
+            -H "Authorization: Token $RTDS_ADS_TOKEN" $RTDS_ADS_PROJECT/versions/latest/builds/
+      - name: When tag 🏷️ pushed - Trigger Readthedocs build
+        if: github.event_name != 'pull_request'
+        env:
+          RTDS_ADS_PROJECT: https://readthedocs.org/api/v3/projects/accelerated-data-science
+          RTDS_ADS_TOKEN: ${{ secrets.RTDS_ADS_TOKEN }}
+        run: |
+          curl \
+            -X POST \
+            -H "Authorization: Token $RTDS_ADS_TOKEN" $RTDS_ADS_PROJECT/versions/${{ github.ref_name }}/builds/