From 3a97d9a0c5cafb577bba4c5b19a7898dda24f231 Mon Sep 17 00:00:00 2001
From: Stijn de Gooijer <stijndegooijer@gmail.com>
Date: Sat, 27 Jul 2024 20:16:20 +0200
Subject: [PATCH] ci(python): On Python release, trigger docs build after API
 reference build (#17904)

---
 .github/workflows/docs-global.yml |  2 +-
 .github/workflows/docs-python.yml | 13 ++++++++++++-
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/docs-global.yml b/.github/workflows/docs-global.yml
index 6a7e0e329346..9444cfd330c1 100644
--- a/.github/workflows/docs-global.yml
+++ b/.github/workflows/docs-global.yml
@@ -8,7 +8,7 @@ on:
       - .github/workflows/docs-global.yml
   repository_dispatch:
     types:
-      - python-release
+      - python-release-docs
   # Allow manual trigger until we have properly versioned docs
   workflow_dispatch:
 
diff --git a/.github/workflows/docs-python.yml b/.github/workflows/docs-python.yml
index b68bc9ee254d..97152a34e903 100644
--- a/.github/workflows/docs-python.yml
+++ b/.github/workflows/docs-python.yml
@@ -51,7 +51,7 @@ jobs:
         run: make html
 
       - name: Deploy Python docs for latest development version
-        if: ${{ github.ref_name == 'main' }}
+        if: github.event_name == 'push' && github.ref_name == 'main'
         uses: JamesIves/github-pages-deploy-action@v4
         with:
           folder: py-polars/docs/build/html
@@ -84,3 +84,14 @@ jobs:
           folder: py-polars/docs/build/html
           target-folder: api/python/stable
           single-commit: true
+
+      # Build global docs _after_ this workflow to avoid contention on the gh-pages branch
+      - name: Trigger global docs workflow
+        if: github.event_name == 'repository_dispatch'
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          event-type: python-release-docs
+          client-payload: >
+            {
+              "sha": "${{ github.event.client_payload.sha }}"
+            }